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ABSTRACT 


The  Radio  Shack  home  computer  system,  TRS-80, 
configured  with  Level  II  Basic  ROS* s,  16K  of  RMi , its 
expansion  interface,  a single  disk  drive,  and  a line 
printer  interface  to  the  Teletype  model  '40  line 
printer  is  being  used  as  a microprocessor  development 
aid  for  the  Z-90  microprocessor . Basic  language 
programs  are  resident  on  the  mini-disk  and  are  used  to 
load, to  store,  to  dump,  and  to  execute  assembled 
assembly  language  programs. 
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I.  INTRODUCTION 


The  inital  condition  of  the  Naval  Postgraduate  School's 
Radio  Shack  home  computer  was  a Level  I basic  system  with 
16K  of  RAN.  This  beginning  system  was  added  to  and  modified 
to  form  a microprocessor  development  aid  for  the  Z-80 
microprocessor. 

Chapter  II  will  discuss  the  conversion  of  the  Level  I 
basic  to  Level  II  basic.  This  being  complicated  by  Radio 
Shack's  lack  of  documentation  and  instructions  was 
accomplished  within  one  afternoon.  With  instructions  it 
would  take  about  fifteen  minutes 

Chapter  III  will  discuss  the  operation  and  construction 
of  the  line  printer  interface.  This  interface  is  controlled 
oy  an  INTEL  8748  microprocessor  and  is  set  to  operate  at 
2400  baud.  A significant  amount  of  time  was  spent  on  this 
due  to  a standard  line  feed  character  not  being  generated  by 
the  TRS-80. 


In  chapter  IV  the  microprocessor  development  aid  is 
discussed  with  application  to  sample  problems.  The  use  of  a 
system  of  basic  language  programs  resident  on  the  mini-disk 
allows  the  operator  to  load,  to  dump,  to  store,  and  to 
execute  assembled  assembly  language  programs.  The  outputs 
of  these  operations  are  either  directed  to  the  video  display 
or  the  line  printer.  Use  of  the  system's  single  step 
execution  program  allows  the  operator  to  trace  the 
operations  on  each  register  as  the  operations  are 
accomplished . 
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The  conclusions  and  recommendations  of  chapter  7 include 
ideas  for  furthering  the  usefulness  of  the  TRS-80  as  a 
development  tool.  The  prospects  of  increasing  the  variety 
of  microprocessors  serviced  by  this  inexpensive  system  is 
very  exciting. 
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The  conversion  to  Level  II  basic  from  Level  I basic  was 
the  first  hardware  change  made  to  tie  Naval  Postgraduate 
School's  TRS-80.  This  changes  the  4K  of  ROM  used  for  Level 
I oasic  to  12K  of  ROM  used  for  Level  II  basic.  An  increased 
instruction  set  and  the  software  to  support  a line  printer 
are  the  motivating  factors  for  this  alteration.  Normally  a 
Radio  Shack  service  center  would  install  and  test  the 
conversion  kit.  Since  this  is  an  electrical  engineering 
thesis,  it  was  decided  that  I would  do  the  conversion  and 
thus  have  an  opportunity  to  study  the  CPU  board. 


The  use  of  Ref.  1 during  the  Level  II  basic  conversion 
is  useful  and  the  only  available  reference.  All  of  the  "Z  " 
numbers  are  on  the  CPU  board  and  therefore  their  locations 
are  relatively  easy  to  find.  A new  )£3  is  provided  with  tne 
conversion  kit  and  is  used  as  is  (DO  NOT  break  any  of  the  13 
connectors).  The  kit  also  has  a 100  ohm  1/4  watt  resistor. 
This  resistor  is  used  to  load  the  recorder  input  but  is  not 
necessary;  therefore,  it  is  not  used 

The  Level  II  basic  ROM's  are  on  a small  4-chip  ROM 
board.  This  ROM  board  is  attached  with  double-sided  tape  to 
the  etched  side  of  the  IPO  board.  The  ROM  board  has  a flat 
ribbon  cable  used  to  connect  it  to  the  CPU  board  at  Z33  or 
Z34 

There  are  four  lose  wires  coming  from  the  ROM  board 
which  must  be  connected  to  the  CPU  board:  A yellow  wire  to 
be  connected  to  address  line  11  (All);  A red  wire  to  be 
connected  to  address  line  12  (A12) ; An  orange  wire  to  be 
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connected,  to  address  line  13  (A  1 3 ) ; A green  wire  to  be 
connected  to  something  called  ROM*.  One  mast  be  careful  for 
the  color  coding  may  change  with  different  ROM  boards. 

ROM*  is  not  defined  in  Ref.  1.  ROM*  must  oa  high  when 
414  or  A 15  is  high  and  is  low  otherwise,  in  order  to  support 
the  memory  map.  Knowing  what  makes  up  ROM*  leads  to  where 
it  connects  on  the  CPU  board.  On  IRS-80  schematic  (sheet  1) 
of  reference  1,  there  is  the  DIP  shunt  13.  This  DIP  shunt  is 
a shorting  bar  array.  By  breaking  some  bars  and  leaving 
others  intact,  the  address  decoder  is  programmed  to  reflect 
the  amount  of  ROM  and  RAM  on  the  CPU  noard.  For  a Level  II 
basic  ROM  and  16K  of  RAM  none  of  the  bars  of  X3  are  broken. 
ROM*  is  now  found  on  pin  7 or  8 of  X3  with  an  unbroken  DIP 
is  installed 


The  wires  connecting  to  All,  A12,  A13  must  all  be 

connected  to  the  output  of  the  tri-state  buffers  which 
isolate  the  CPU.  Connect  the  yellow  wire  (All)  to  pin  5 of 
Z37,  the  red  wire  ( A1 2 ) to  pin  13  of  Z21,  the  orange  wire 
(A13)  to  pin  3 of  Z21,  and  the  green  wire  (ROM*)  to  pin  3 of 


Appendix  A contains  a step-by-step  procedure  for  the 
above  conversion. 
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To  obtain  hard  copy  -f  output  data  and  program  listings 
is  an  important  part  of  any  computer  system.  The  TRS-80 
expansion  interface  has  two  printer  ports.  One  port  is  a 
screen  printer  port  and  interfaces  with  the  Radio  Shack 
screen  printer.  This  port  is  a pin  for  pin  copy  of  the 
40-pin  edge  connector  which  connects  the  CPU  board  with  the 
expansion  interface.  The  other  port  is  a line  printer  port 
which  interfaces  with  the  Radio  Shack  line  priater.  This 
port  is  a 32-pia  port.  It  sends  TTL  data  lines  in  parallel 
and  receives  four  handshaking  signals. 

Given  the  need  for  hard  copy  output  and  the  existence  of 
a line  printer  which  receives  RS-232  signals,  an  interface 
was  constructed  to  convert  the  TRS-30's  expansion  interface 
and  the  Teletype  model  43  line  printer. 


A.  OPERATION  OP  THE  LINE  PRINTER  INTERFACE 


The  line  printer  interface  must  interface  between  the 
TTL  parallel  output  and  handshaking  signals  of  the  expansion 
interface  and  the  RS-232,  at  2400  baud,  signals  of  the 
Teletype  model  40  line  printer.  A universal  asynchronous 
receiver/transmitar  (UAR/T)  the  AT-5-1013  is  used  with  a 
quad  NDTL  line  driver  the  MC1438  to  convert  the  parallel 
output  of  the  expansion  interface  to  2400  baud  RS-232 
signals.  A handshaking  signal  from  the  line  printer  is 
converted  to  TTL  logic  in  a quad  SDTL  line  receiver  the 
SC  14 89. 
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The  IBS- 80  software  does  not  genecate  an  ASCII  line  feed 
character  at  the  end  of  a line.  This  requires  a smart  line 
printer  interface.  An  INTEL  8748  is  used  to  control  the 
handshaking  signals,  aoiitor  the  parallel  output  from  the 
TBS-80,  and  when  required  take  control  of  the  printer  to 
generate  a line  feed  character.  A line  feed  is  generated 
after  the  TBS-80  transmits  a carriage  return. 

Whenever  the  line  printer  interface  and  the  disk  drive 
are  connected  to  the  expansion  interface,  the  line  printer 
interface  must  be  turned  on.  The  lack  of  the  proper 
handshaking  signals,  when  the  line  printer  interface  is  off, 
will  prevent  disk  operation  on  start  up  and  lock  up  the 
system  during  operation.  Before  the  first  use  of  the  line 
printer  interface  after  a shut  down  the  BESET  button  must  be 
pressed  on  the  line  printer  interface  to  insure  proper 
restart  of  the  8748. 


3.  INSIDE  THE  LINE  PBINCEB  INTERFACE 


Inside  the  line  printer  interface  is  divided  into  four 
parts.  The  transmit  data  path  is  discussed  first.  This  is 
the  path  from  the  TBS-80  through  the  line  printer  interface 
to  the  line  printer.  The  second  part  is  the  received  data 
path  which  is  the  handshake  signal  from  the  line  printer  to 
the  TBS-80.  The  control  signals  are  generated  next  and  pull 
together  both  transmit  and  receive  signals  along  with  the 
necessary  clock  pulses.  The  power  supply  of  the  line 
printer  interface  is  examined  for  possible  trouble  shooting 
at  a later  date. 

The  line  printer  interface  is  made  from  three  LSI  and 
five  SSI  building  blocks.  One  3748  microprocessor,  one 
AI-5-1013  CJAR/T,  one  8212  eight-bit  input/output  port,  one 
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74126  tri-state  quad  juffer,  one  MC1488  quad  MDTL  line 
driver,  one  MC1489  quad  3DTL  line  receiver,  and  two  7492 
divide-by-12  counters  are  the  integrated  circuit  components 
of  the  line  printer  interface.  Thera  are  an  additional  six 
SSI  building  blocks  on  the  expansion  interface  which  support 
the  line  printer.  These  circuits  decode  the  line  printer 
driver  address,  store  the  output  data  character,  receive  the 
handshaking  signals,  and  produce  a 1/2  microsecond  negative 
going  data  strobe  to  signal  when  data  is  present.  Detailed 
data  on  the  operation  of  all  the  components  of  the  line 
printer  interface  appear  in  Refs.  2,  3 and  4. 

1 . Transmit 

The  transmit  data  path  through  the  line  printer 
interface  is  shown  in  figure  1.  Parallel  data  is  latched  on 
the  expansion  interface.  This  data  is  passed  through  the 
8212  configured  as  an  output  port  to  the  UAR/T.  The  8748 
can  read  the  data  which  is  passed  to  the  UAR/T  or, as  will  be 
seen  during  the  control  discussion,  the  3748  can  write  data 
to  the  UAR/T.  The  (JAR/T  changes  the  data  from  parallel  to 
serial  at  the  baud  rate  maintained  oy  tne  control  signals. 
The  TTL  serial  output  of  the  UAR/T  is  changed  to  RS-232 
logic  in  the  CJC1488  and  sent  to  the  line  printer  through  pin 
3 of  an  RS-232  connector. 

2 . Receive 

The  receive  data  path  from  the  line  printer  to  the 
expansion  interface  is  shown  in  figure  2.  Pin  14  of  the 
RS-232  connector  is  the  receive  next  character  (RRC)  signal 
of  the  line  printer.  Whan  this  signal  is  low,  the  line 
printer  is  not  ready  to  receive  the  next  character.  Likewise 
when  this  signal  is  high,  the  printer  is  ready  to  receive  a 
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character.  The  HS-232  logic  of  the  printer  is  changed  to 
TTL  logic  by  the  MC1489.  k low  on  LP-23  of  the  expansion 
interface  causes  the  TR5-80  to  halt  until  LP-23  goes  high. 
This  is  also  connected  to  T1  of  the  8748  for  use  in  the 
control  sequence.  The  timing  is  such  that  this  signal  will 
not  slow  down  the  process  unless  a line  feed  or  a form  feed 
is  being  executed. 

3.  Control 

The  control  of  the  line  printer  interface  is  shown 
in  figure  3.  The  9748  performs  two  control  functions.  It 
monitors  the  transmitted  characters  and  inserts  i line  feed 
character  after  each  carriage  return  character.  Ihe  clock 
for  the  UAR/T,  a clock  at  sixteen  times  the  desired  baud 


rate,  originates  from  the  8748. 

The  control  of  the  line  feed  character  generation 
works  as  follows.  Three  of  the  data  lines  of  port  Pi  and 
one  of  the  data  lines  of  port  P2  of  the  8748  are  used  for 
control.  initially,  the  SOS  port, which  is  monitoring  the 
transmitted  character,  is  in  a high  impedance  state.  P12  is 
high,  enabling  the  8212  through  one  of  the  74126' s buffers 
used  as  a driver.  P11  is  low,  enaoling  the  TR5-83  through 
LP-21  and  a tri-state  buffer  on  the  expansion  interface 
which  leads  to  D7  of  the  CPU.  P13  is  low,  disabling  the 
74126 's  tri-state  buffer  which  drives  P20.  P20  is  high,  but 
disconnected  from  the  data  strobe  of  the  UAR/I  (DS(not)). 
LP-26  is  a clear  Line  for  the  D flip-flops  on  the  expansion 
interface  which  stores  the  transmitted  character;  it  is 
wired  high  to  disable  the  clear.  The  interrupt  is  enabled. 


The  transmit  sequence  follows.  A character  is 
latched  to  the  D flip-flops  on  the  expansion  interface. 
This  character  passes  through  the  8212  and  appears  on  the 
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data  lines  of  the  UAH/T  and  the  BOS  of  the  8748.  A negative 
going  pulse  of  about  1/2  ticrosecond  is  generated  on  the 
expansion  interface  and  is  passed  from  LP-1  through  the  8212 
to  OS  (not)  of  the  OAB/T.  The  end  of  character  line  (EOC)  of 
the  (JAfi/T  goes  low,  interrupting  the  9748,  and  the  character 
is  transmited  by  the  tJAR/I.  The  interrupted  8743  stops  the 
TRS-80  by  sending  P11  high.  It  then  inputs  on  the  BOS  the 
character  and  checks  it  to  see  if  it  is  a carriage  return 
(QDH) . If  a carriage  return  character  is  not  being 
transmitted,  then  the  8748  starts  its  end  of  interrupt 
sequence  (to  be  described  later)  . If  a carriage  return  is 
being  transmitted,  then  the  8749  waits  for  the  EOC  to  go 
high.  At  that  tiae,  P12  goes  low  to  disable  the  8212 
(places  it  in  a high  impedance  state)  and  P10  goes  high 
enabling  tne  74126's  buffer  to  connect  P20  to  DS  (not)  of  the 
(JAfi/T.  A line  feed  character  (OAH)  is  places  on  the  8748's 
BOS.  P20  goes  low,  then  high,  thus  generating  a data  strobe 
for  the  OAH/T.  A line  feed  character  is  now  being 
transmitted.  The  8748  starts  its  and  of  interrupt  sequence. 

During  the  end  of  interrupt  sequence,  the  8748  waits 
for  the  EOC  to  go  high,  then  it  waits  for  T1  to  go  high. 
This  means  the  8748  waits  for  the  UA3/T  to  finish 
transmitting,  than  it  waits  for  the  printer  to  say  it  is 
ready.  When  these  things  are  true,  a return  from  interrupt 
is  executed.  After  the  interrupt  is  reenabled,  the  initial 
conditions  are  reestanlished  and  the  transmission  of  the 
next  character  is  started. 

Appendix  B is  a complete  listing  of  the  program 
resident  on  the  8748.  ilong  with  supporting  the  above,  the 
8748  also  generates  the  clock  for  the  UAH/T.  The  clock  is 
generated  by  the  8748's  instruction  ENTO  CLK  which  places 
1/3  the  8748's  clock  on  the  test  line  TO.  This  clock  is 
divided  by  twelve  and  two  by  7492  divide-by-twelve  counters 
before  the  clock  goes  to  the  (JAR/T  at  sixteen  rimes  the  baud 
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cate.  The  variable  inductor  is  used  to  fine  tune  the  8748' s 
clock,  thus  fine  tuning  the  2400  baud  of  the  3AR/T.  To 
change  to  4800  baud,  disconnect  the  divide-by-two  counter. 
Similarly  to  change  to  9600  baud,  disconnect  the 
divide-by-two  counter  and  rewire  the  divide- by-twelve 
counter  to  make  a divide-by-six  counter. 

The  reset  button  wiring  is  shown  as  part  of  control, 
figure  3.  Before  one  tries  to  disassemble  the  liae  printer 
interface  case,  the  reset  button  must  be  disconnected  first. 

4.  Power 

The  power  supply  for  the  line  printer  interface  is 
provided  by  a surplus  radio  telegraph  power  supply.  It  is 
rated  at  .5  amp  at  5 volts,  125  ma  at  +12  volts,  and  125  ma 
at  -12  volts.  Figure  4 shows  the  power  supplies  needed  for 
the  line  printer  interface.  Pins  34-39  of  the  UAR/T  set  up 
the  UAR/T  for  one  stop  bit,  seven  bits  per  character,  and 
even  parity.  Pins  13  and  4 are  high  on  the  74126  to 
permanently  enable  two  of  the  74126' s tri-state  buffers  as 
drivers. 


C.  CONSTRUCTION  DP  THE  LINE  PRINTER  INTERFACE 


The  line  printer  interface  is  constructed  on  a 
six-by-four  inch  perforated  board  using  wire  wrap  sockets. 
The  use  of  the  wire  wrap  technique  is  a very  significant 
contribution  to  the  success  of  the  liae  printer  interface. 
The  author  has  used  wire  wrapping  on  two  other  projects  and 
never  experienced  a short  or  an  open.  He  strongly 
recommends  this  technique  for  any  prototype  project. 
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The  forty  pin  edge  connecting  cable  from  the  line 
printer  interface  to  the  expansion  interface  is  identical  to 
the  cable  from  the  CPU  board  to  the  expansion  interface. 
There  are  two  plastic  lugs  on  each  side  of  the  edge 
connector  going  to  the  32  pin  line  printer  port  on  the 
expansion  interface.  This  cable  cannot  be  connected 
backwards,  but  it  can  be  connected  upside  down.  The  cable 
should  be  connected  as  all  the  other  cables  entering  the 
expansion  interface. 
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SI3ROPR3CESSOH  DEVELOPMENT  AID 


The  major  :oq tribution  of  this  thesis  is  a disk 
operating  microprocessor  development  aid  for  the  Z-80 
microprocessor.  Since  the  INTEL  8030  language  is  a subset 
of  the  Z-80  language,  this  development  aid  is,  in  all 
respects,  an  8080  microprocessor  development  aid  as  well. 
Since  the  Naval  Postgraduate  School  has  other  and  more 
sophisticated  development  aids  for  the  8080,  the  use  of  this 
system  will  find  its  most  pratical  use  with  the  Z-80. 

The  cost  of  the  TRS-80,  as  presently  configured, 
compares  favorably  with  the  prompt-80/85.  The  system  of 
basic  language  programs  which  operates  the  IHS-80  as  a 
microprocessor  development  aid  performs  all  of  the  functions 
of  the  prompt-80/85  with  the  exception  of  the  PROM 
operations.  Consideration  will  be  given  to  extending  this 
Z-80  development  aid  to  include  PROM  operations.  In 
addition  to  the  prompt-80/85  functions,  this  system  has  a 
single  step  execution  operation  which  allows  either  hardcopy 
or  video  display  of  the  registers  after  each  step. 

A.  THE  SXSTEM 


The  entire  basic  program  to  support  the  microprocessor 
development  aid  takes  less  then  1 1 K oc  RAM.  In  a TR5-80  with 
16K  of  RAM  rhat  would  leave  about  5K  of  RAM  for  the  machine 
language  programs.  To  facilitate  the  use  of  the  system  and 
memory  usage,  the  TRS-30  disk  operating  system  (TRSDOS)  is 
used. 


23 


The  software  to  support  the  TRSDOS  uses  about  10K  of 
RAM,  leaving  less  than  6 K of  RAH  for  the  system  programs. 
The  basic  programs  are  segmented  into  functional  groups 
using  less  than  2K  of  RAM  each.  Each  of  these  small 
programs  which  are  resident  on  the  dish  are  called  from  the 
dish  by  the  monitor  program.  Each  of  the  program  segments 
calls  another  segment  is  its  last  step,  thus  the  system  of 
programs  loop  from  one  to  another. 

Hita  10K  of  RAM  used  by  T3S DOS  and  about  2K  of  RAM  used 
by  the  basic  programs,  this  leaves  a little  more  than  3K  of 
RAM  for  the  assembled  assembly  language  programs.  Any  time 
an  assembly  language  program  of  greater  than  3K  is  being 
developed,  the  developer  should  tainh  about  a higher  level 
language  to  produce  his  software.  When  the  Naval 
Postgraduate  School's  IR5-80  RAM  is  expanded  to  48K,  the 
same  restriction  should  oe  followed. 

On  system  start  up,  the  number  of  files  question  should 
be  answered  by  pressing  ENTER;  this  defaults  with  three 
files.  Since  each  file  requires  about  285  bytes  of  RAM,  any 
answer  other  than  the  default  will  rob  tne  system  of  the  RAM 
required  for  executing  its  program.  The  memory  size 
question  should  be  answered  with  29630  ENTER.  This  protects 
3K  of  RAM  for  the  user's  assembly  language  programs. 

The  use  of  this  system  is  very  much  dependent  upon  a 
strong  background  in  3080  and  Z-90  assembly  language. 
References  7,  8,  9,  and  10  are  recommended  for  the  beginner 
in  that  order.  An  understanding  of  the  assembly  language  and 
how  it  operates  within  the  microprocessor  cannot  be  replaced 
by  this  system  of  basic  Language  programs. 

S.  THE  BASIC  PROSHA MS 
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The  programs  used  to  support  the  microprocessor 
development  aid  are  written  in  TRS-80  Disk  Basic,  reference 
5 and  6 apply.  Their  execution  is  slower  than  that  of 
similar  operating  systems  which  are  assembly  language  based. 
An  asserted  attempt  has  been  made  to  have  th  inputs  and  the 
outputs  closely  resemble  their  counterparts  in  T-3UG  and  the 
TEKTRONIX  3002  systems.  The  programs  are  interactive  in 
nature  and  require  a developer’s  response  at  appropriate 
times  during  execution. 

Examples  of  the  use  of  these  programs  ace  given  as 
sample  labs  in  Appendices  X,  Y , and  Z.  Use  of  these  Ians 
will  be  discussed  later  ia  this  chapter. 

All  of  the  basic  programs,  but  one,  are  protective  files 
as  defined  in  Ref.  6.  They  cannot  be  loaded,  altered  or 
executed  without  the  use  of  their  password.  The  password 
used  by  all  the  programs  is  DFC,  the  initals  of  the  author. 
The  disk's  master  password  is  the  same  as  given  ia  Ref.  6. 
It  is  not  necessary  to  use  or  even  know  either  password  when 
using  this  microprocessor  development  aid. 

The  basic  programs  of  Appendices  C through  N,  and  P 
through  S are  identical  in  content  to  those  resident  on  the 
disk.  However,  to  save  memory  locations,  unnecessary  spaces 
have  been  deleted  for  the  programs  on  the  disk.  Since  this 
entire  thesis  is  being  generated  by  the  TPS  program,  on  the 
IBM  360,  the  appendices  have  additional  spaces  generated  by 
TPS  to  make  them  more  pleasing  to  the  eye.  Additionally  the 
subroutine  calls,  which  appear  in  most  of  the  programs,  call 
line  numbers  not  present  in  Appendices  C through  N,  and  P 
through  S.  These  subroutines  appear  in  Appendices  T,  U,  and 
V,  but  are  resident  oa  the  disk  ia  the  basic  program  whan 
required. 
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1 . Monitor  Program 

The  monitor  program,  Appendix  C,  functions  as  its 
name  implies.  It  establishes  a starting  position  for  the 
microprocessor  development  aid  and  allows  the  operator  to 
chose  the  type  of  operation  which  he  wants  to  accomplish.  To 
start  the  monitor  and,  therefore,  start  the  microprocessor 
development  aid,  type  RQM ••  S '•  and  then  press  ENTER.  This  will 
load  and  run  the  monitor  program.  "S''  is  a program  which  is 
one  line  long;  that  line  is  SON  "MON I TOR /BAS. DFC: 0"  which 
could  be  entered  directly.  What  occurs  on  RON  "3"  is  that 
the  monitor  program  is  found  on  dish  drive  0 and  loaded  into 
the  RAM  and  then  executed. 

The  first  requested  input  from  the  monitor  program 
is  a request  for  one  of  two  letters  S or  L.  These  stand  for 
a short  (very  short)  or  long  explanation  of  the  commands 
which  are  recognized  oy  the  monitor  program.  If  the 
operator  enters  some  character,  group  of  characters,  or  the 
null  character  (by  just  pressing  ENTER) , the  program 
defaults  by  responding  with  the  short  explanation. 

After  the  operator  responds  to  and  receives  his 
explanation,  the  program  asks  for  a mode  of  operation.  The 
operator  must  then  respond  with  one  of  a set  of  characters 
used  in  the  explanation.  If  the  operator  enters  a different 
string  of  characters,  then  what  appears  in  the  explanation 
(spaces  count)  , the  program  defaults  with  the  short 
explanation.  It  will  continue  giving  the  short  explanation 
until  a proper  string  of  characters  is  entered. 

Upon  receiving  a proper  string  of  characters  the 
monitor  program  directs  the  locating,  loading  and  execution 
of  a new  program.  At  the  end  of  this,  the  monitor  program  is 
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no  longer  in  the  RIM.  The  monitor  program  is  reloaded  as  a 
final  step  to  each  of  the  other  modes  of  operation.  Thus, 
the  microprocessor  development  aid  is  self  perpetuating. 


If,  for  any  reason,  the  operator  requires  to  get  to 
the  monitor  program  at  some  other  time,  press  BREAK  then 
type  RON  "5”  and  press  ENTER. 


2 . Dump  Mode 


To  start  the  dump  mode  program.  Appendix  D,  from  tha 
monitor  program  type  DUMP,  then  press  ENTER  when  the  mode  is 
requested.  This  program  will  provide,  either  in  hard  copy  or 
on  the  video  display,  tha  contents  (in  hexadecimal  code)  of 
any  memory  location  or  string  of  memory  locations  up  to  and 
including  the  entire  64K  of  RAH  addressaole  by  the  Z-80. 

The  operator  must  provide,  when  asked,  a starting 
memory  location  in  decimal,  the  number  of  memory  locations 
in  decimal  and  an  indication  of  video  or  line  printer 
output.  There  is  no  defauit  on  the  type  of  output,  so  if  tha 
operator  enters  something  other  than  a single  latter  V for 
video  or  the  two  letter  string  LP  for  the  line  printer, 
there  will  be  no  output.  The  data  is  outputted  in  the 
following  format  per  line:  starting  memory  location  of  tha 
line  in  decimal;  starting  memory  location  of  tha  line  in 
hexadecimal;  followed  with  sixteen  bytes  of  data  from  the 
next  sixteen  memory  locations. 

After  the  requested  data  is  outputted,  tha  program 
gives  the  operator  an  opportunity  to  start  the  dump  program 
again.  Tha  program  defaults  on  any  character  string  other 
than  TES  to  the  monitor  program. 
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The  load  aoda  program,  Appendix  E,  is  entered  by 


typing  LOAD  and  pressing  ENTER  when  the  mode  is  requested 
during  the  monitor  program.  This  program  operates  almost 
identically  to  the  '•eicam'*  command  of  the  TEKTRONIX  8002. 
The  operator  will  be  required  to  enter  a starting  memory 
location  in  decimal.  The  location  should  be,  but  is  not 
limited  to,  the  reserved  RAM  locations  7400  to  7FFF  (29696 
to  32767  decimal)  which  are  protected  on  startup.  Since  this 
program  changes  the  contents  of  RAM  locations,  to  use  it  at 
RAM  location  other  than  7400  to  7FFF  Rex  invites  disaster, 
for  the  operator  can  end  up  changing  something  that  should 
not  be  changed. 

The  program  outputs  the  hexadecimal  memory  location 
and  its  currant  contents.  When  a question  mark  (?)  appears, 
the  operator  can  change  the  memory  location  by  typing  a two 
digit  hexadecimal  code  and  pressing  ENTER.  The  program 
defaults  using  only  the  first  two  characters  of  any 
multi-character  string.  If  no  characters  are  typed  and  ENTER 
is  pressed,  the  memory  location  is  unchanged  and  the  program 
proceeds  to  the  next  memory  location.  The  memory  location 
always  increases  and  never  decreases. 


To  stop  the  loading  process  type  itJIT  and  press 
ENTER.  This  will  start  the  monitor  program. 

4 . Execution  Mode 

The  execution  mode  program.  Appendix  F,  is  entered 
by  typing  EXEC  and  pressing  ENTER  waen  the  mode  request  is 
made  during  the  monitor  program.  This  program  requires  a 
decimal  number  which  is  used  as  a starting  memory  location. 
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The  program  transfers  control  so  that  the  machine  language 
code  is  executed  starting  at  that  memory  Location.  This 
execution  is  similar  to  the  GO  command  of  the  prompt  80/85. 
The  execution  is  stopped  and  control  transferred  back  to  the 
basic  language  program  upon  execution  of  a return  which  was 
not  proceeded  by  a call  in  the  assembly  language  program. 
The  USEO  instruction  is  used  to  transfer  control.  See  Befs. 
5 and  6. 


When  execution  is  complete,  the  operator  is  asked  if 
further  execution  is  raguired.  If  so,  a IES  is  typed  and 
ENTER  pressed,  then  the  basic  language  execution  mode 
program  is  restarted  asking  for  a starting  memocy  location 
in  decimal.  The  program  defaults  on  any  other  character 
string  than  IES  to  the  monitor  program. 

The  use  of  this  mode  should  be  limited  to  assembly 
language  programs  which  have  already  been  debugged.  Since 
the  execution  is  very  rapid,  at  the  2-80  clock  rate,  any 
attempt  to  see  single  steps  would  be  useless.  Techniques 
for  writing  Z-80  assembly  language  programs  for  this  system 
are  discussed  later. 


5.  Single  Step  Execution  Mode 


The  single  step  execution  mode  is  a system  of  eight 
basic  language  programs.  Appendices  3 through  N,  and  one 
machine  language  program.  Appendix  3.  The  system  of 
programs  is  started  by  typing  SS  EXEC  and  pressing  ENTER  in 
response  to  the  mode  question  of  the  monitor  program. 
Single  step  execution  will  provide,  either  in  hardcopy  or  on 
the  video  display,  the  program  counter  of  the  step  being 
executed.  The  contents  of  each  working  registec  and  the 
stack  pointer,  after  the  step  is  executed,  is  also 
outputted.  The  primary  use  of  this  sat  of  programs  is  as  a 


29 


I 


debugging  aid.  For  loig  machine  Language  programs  the 
hardcopy  output  is  essential,  since  the  video  display  will 
contain  no  more  than  twelve  lines  of  output.  What  follows  is 
a functional  explanation  for  each  of  the  nine  separate 
programs  which  make  up  the  single  step  execution  node. 

Single  step  execution  program,  Appendix  3,  is  tne 
executive  program  of  the  single  step  execution  mode.  It  is 
run  only  once  during  the  single  step  procedure,  and  this 
does  the  preliminary  accounting  procedures  required  for 
execution.  It  first  loads  the  machine  language  program, 
appendix  0,  into  memory.  The  question  of  output  is  then 
addressed.  The  operator  responds  with  a 7 or  LP  for  either 
video  or  line  printer  output.  The  type  of  output  is  stored 
in  the  least  significant  bit  of  memory  location  73D0  Hex. 
There  is  no  default  for  output;  a zero  in  this  location 
causes  video  output  and  a one  causes  line  printer  output. 
If  some  other  string  of  characters  is  used  to  answer  the 
output  question,  the  contents  of  this  bit  remains  unchanged 
and  the  output  is  either  video  or  line  printer.  The  last 
entry  by  the  operator  in  this  mode  is  a starting  memory 
location  in  decimal.  This  location  is  now  used  by  the  system 
of  programs  as  the  program  counter  and  is  stored  in  memory 
location  73D2  and  73D3.  Since  the  single  step  mode  is  using 
several  programs,  any  information  to  be  passed  between  the 
programs  must  be  stored  in  the  protected  part  of  the  HAM. 
Appendix  W shows  a memory  map  of  tne  protected  portion  of 
the  HAM  used  by  the  single  step  execution  mode. 

The  Appendix  G program,  as  a final  step,  loads  and 
executes  single  step  execution  program  1,  Appendix  H.  This, 
as  well  as  the  remaining  single  step  execution  programs,  has 
no  interactions  with  the  operator.  The  program  sets  memory 
location  73D1  to  zero.  Memory  location  73D1  is  called  K 
throughout  this  sat  of  programs.  The  output  bit  from  memory 
location  73D0  is  checked  and  a header  is  outputted  as 
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required.  This  header  labels  each  of  the  columns  of  the 
output.  The  single  step  execution  program  1 is  returned  to, 
after  ten  machine  language  program  steps  are  accomplished. 
This  process  would  be  accomplished  as  a do-loop  if  the 
single  step  execution  mode  was  one,  not  eight  basic 
programs. 


The  Appendix  H program,  as  a final  step,  loads  and 
executes  single  step  execution  program  2,  Appendix  I.  This 
program  performs  a very  fundamental  function  of  a single 
step  routine;  it  translates  the  hexadecimal  coda  of  the 
contents  of  the  program  counter’s  memory  locatioa  into  the 
length  in  bytes  of  the  instruction  to  be  executed.  The 

; if’ 

variable  N2  is  used  to  store  the  number  of  bytes  per  current 
instruction,  see  Appendix  W.  Instead  of  using  this  variable 
in  single  step  execution  program  2,  the  program  loads,  then 
executes  one  of  the  four  programs.  Appendices  J through  a, 
depending  on  the  number  of  bytes. 


If  single  step  execution  program  3 is  executed  next, 
then  the  instruction  to  be  executed  is  one  byte  in  length. 
There  are  four  distinct  cLasses  of  one  byte  instructions  in 
the  Z-80  language.  Thera  is  a class  which  does  not  change 
the  program  counter  except  to  move  it  down  to  the  next 
instruction.  Minty  percent  of  the  single  byte  instructions 
are  like  this.  Aaother  class  is  one  that  only  changes  the 
program  counter.  The  only  single  byte  instruction  of  this 
class  is  the  JP(HL)  instruction.  The  third  class  may  change 
the  program  counter  and  the  stack  pointer.  These  are  the 
return  and  conditional  return  instructions.  The  last  class 
are  the  restart  instructions.  The  single  step  execution 
program  3 separates  these  four  classes  of  single  byte 
instructions  and  set  control  codes  to  insure  their  proper 
execution  within  the  single  step  framework.  An  instruction 
which  does  not  change  the  program  counter  will  set  H5  to  1 
and  M6  to  3.  An  instruction  to  jump  to  HL  will  set  H5  to  1, 
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M6  to  1,  and  places  the  new  program  counter  in  memory 
locations  73E8  and  73E9.  The  returns  ch9ck  to  see  if  the 
return  has  had  a corresponding  call.  The  conditional 
returns  are  checked  for  the  truth  of  the  condition.  If  the 
return  has  a corresponding  call,  the  returning  program 
counter  is  placed  in  memory  locations  73E8  and  73E9;  the 
stack  pointer  is  caused  to  increment  twice;  85  is  set  to  1 
and  86  is  sat  to  1 . If  the  return  is  a conditional  return 
failing  its  condition,  85  is  set  to  1 and  86  is  set  to  2. 
If  the  return  does  not  have  a corresponding  call,  then  it  is 
an  end  of  program  return;  85  is  set  to  2 and  86  is  set  to  1. 
& restart  instruction  is  not  executed  since  its  execution 
would  transfer  control  to  a Level  II  basic  R08  memory 
location,  A restart  sets  85  to  1,  86  to  2,  and  prints  a 
diagnostic  on  the  video  display.  85  and  85  are  control 
variables  which  ace  stored  in  memory  location  7300,  prior  to 
the  loading  and  execution  of  single  step  execution  program 
7,  Appendix  N,  as  a last  step  of  this  program. 

Single  step  execution  4,  Appendix  K,  is  executed 
next,  if  tne  instruction  being  executed  is  two  bytes  long. 
There  are  four  classes  of  the  two  byte  instructions.  One 
type  is  executed  directly  and  does  not  change  the  program 
counter.  These  instructions  set  85  to  1 aid  86  to  3. 
Another  class  ace  the  jumps.  The  JP  (IX)  and  JP  (II) 
instructions  each  set  85  to  1 and  86  to  1,  then  place  a new 
program  counter  in  memory  locations  73E8  and  73E9.  The 
relative  jump  instruction  decodes  the  new  program  counter 
and  then  does  the  same  as  JP  (IX) . The  conditional  relative 
jumps  with  a tcue  condition  act  as  a relative  jump.  If  a 
false  condition  exists,  then  85  is  sat  to  1 and  85  is  set  to 
2.  If  the  special  decrement  relative  jump  (DJNZe)  is  being 
executed,  then,  in  addition  to  the  conditional  relative  jump 
procedure,  the  B register  must  be  decremented.  The  third 
class  is  the  return  from  interrupt  and  return  from 
nonmaskable  interrupt.  This  class  sets  85  to  1 and  86  to  2, 
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and  then  outputs  a diagnostic  to  the  video  display.  The 
instructions  RETI  and  REIN  are  emulated  with  no  operations 
(NOP) . The  last  class  of  two  bytes  instructions  are  the 
iterative  load,  compare,  input  and  output  instructions 
(LOIR , LDDR,  CPIR,  CPDR,  INIR,  INDR,  3TIR,  and  OIDR) . They 
set  85  to  1 and  86  to  3 which  allows  their  execution  to 
completion.  A diagnosic  is  outputted  to  the  video  which 
explains  that  these  instructions  are  executed  directly  with 
only  one  line  of  output.  The  control  variables  85  and  86 
are  then  stored  in  memory  location  73D0;  and  the  single  step 
program  7,  Appendix  N,  is  loaded  and  executed. 

Single  step  execution  program  5,  Appendix  L,  is 
executed  if  the  instruction  being  executed  is  three  bytes  in 
length.  There  are  three  classes  of  three  byte  instructions. 
The  ones  which  do  not  change  the  program  counter  are 
executed  directly.  The  control  variables  85  is  sat  to  1 and 
86  is  set  to  3.  The  second  class  is  the  jump  and 
conditional  jumps.  The  jump  will  set  85  to  1 and  86  to  1, 
and  store  the  new  prograa  counter  in  memory  locations  73E8 
and  73E9.  A conditional  jump  is  checked  for  the  truth  of 
the  condition.  If  the  condition  is  true,  then  it  is  treated 
Like  a jump.  If  the  condition  is  false,  then  85  is  set  to  1 
and  86  is  set  to  2.  The  third  class  is  the  call  and 
conditional  calls.  These  act  lixe  j^mps  and  conditional 
jumps  with  additional  actions.  The  current  program  plus 
three  must  appear  to  be  pushed  on  the  stack;  the  stack 
pointer  decreased  by  two;  and  84  which  is  stored  at  73D4  is 
decreased  oy  one.  The  control  variables  85  and  86  are  stored 
at  73D0;  then  single  step  execution  program  7,  Appendix  N, 
is  loaded  and  executed. 

Single  step  execution  program  5,  Appendix  8,  is 
executed  if  the  instruction  being  executed  is  four  bytes 
long.  The  Z-80  language  does  not  have  any  four  byte 
instruction  which  changes  the  program  counter.  This  program 
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sets  the  control  variables  115  to  1 and  36  to  3,  and  then 
stores  then  in  meaory  location  7300.  The  single  step 
execution  program  7,  Appendix  M,  is  then  loaded  and 
executed. 

Single  step  execution  program  7,  Appendix  tfr  is  the 
ending  executive  program  for  each  machine  language  program 
step.  The  program  decodes  K which  is  the  number  of  lines 
that  this  program  has  printed  since  the  last  register  header 
or  single  step  execution  program  2 was  printed.  LP  is 
decoded.  If  LP  is  oaa,  then  output  goes  to  the  line 
printer.  If  LP  is  zero,  then  output  goes  to  the  video 
display.  M3  is  decoded  as  the  current  program  counter.  If  a 
jump,  call  or  return  is  to  be  executed,  then  Ml  is  decoded 
as  the  new  program  counter.  M5  is  decoded  as  1 or  2.  36  is 
decoded  as  1,  2 or  3.  M2  is  decoded  as  the  byte  length  of 
the  machine  language  instruction  being  executed.  If  36  is 
1,  then  the  new  pcogram  counter.  Ml,  is  stored  in  73D2  and 
73D3  and  the  machine  language  program  of  appendix  0 is 
executed.  If  36  is  2,  than  Ml  is  sat  to  M2  plus  M3  (i.e., 
the  new  pcogram  counter  is  the  old  pcogram  counter  plus  the 
number  of  bytes  of  the  executing  instruction) ; and  the  steps 
done  for  36  equal  to  1 are  carried  out.  Por  both  36  set  to 
1 or  2,  the  contents  of  73E8  to  73EB  are  either  no 
operations  (NOP)  or  previously  set  in  single  step  execution 
programs  3,  4 or  5.  If  36  is  3,  than  the  instruction  being 
executed  is  placed  in  73E8  to  73EB  (whith  NOP's  in  empty 
locations);  and  the  steps  used  when  35  is  2 are  carried  out. 
Upon  returning  from  the  machine  language  program  of  appendix 
0,  the  program  counter,  registers  and  stack  pointer  are 
assembled  and  outputted  as  the  variable  LP  dictates.  If  35 
is  2,  then  the  machine  laaguage  pcogram  is  over  (one  more 
return  than  calls) . An  end  of  execution  message  is  printed 
on  the  video  display  and  the  monitor  program  is  loaded  and 
executed.  If  35  is  1,  then  one  is  added  to  i.  If  K is 
greater  than  9 (i.e.  ten  lines  of  output  has  been 


sets  the  control  variables  35  to  1 and  36  to  3,  and  then 
stores  then  in  memory  location  73 DO.  The  single  step 
execution  program  7,  Appendix  N,  is  then  loaded  and 
executed. 

Single  step  execution  program  7,  Appendix  M,  is  the 
ending  executive  program  for  each  machine  language  program 
step.  The  program  decodes  K which  is  the  number  of  lines 
that  this  program  has  printed  since  the  last  register  header 
of  single  step  execution  program  2 was  printed.  LP  is 
decoded.  If  LP  is  one,  then  output  goes  to  the  line 
printer.  If  LP  is  zero,  then  output  goes  to  the  video 
display.  M3  is  decoded  as  the  current  program  counter.  If  a 
jump,  call  or  return  is  to  be  executed,  then  SI  is  decoded 
as  the  new  program  counter.  M5  is  decoded  as  1 or  2.  36  is 
decoded  as  1,  2 or  3.  S2  is  decoded  as  the  byte  length  of 
the  machine  language  instruction  being  executed.  If  36  is 
1,  then  the  new  program  counter,  HI,  is  stored  in  7302  and 
73D3  and  the  machine  language  program  of  appendix  0 is 
executed.  If  M6  is  2,  then  N1  is  set  to  H2  plus  S3  (i.e., 
the  new  program  counter  is  the  old  program  counter  plus  the 
number  of  bytes  of  the  executing  instruction) ; and  the  steps 
done  for  £16  equal  to  1 are  carried  out.  For  both  36  set  to 
1 or  2,  the  contents  of  73E8  to  73EB  are  either  no 
operations  (NOP)  or  previously  set  in  single  step  execution 
programs  3,  4 or  5.  If  36  is  3,  than  the  instruction  being 
executed  is  placed  in  73E8  to  73EB  (whith  HOP'S  in  empty 
locations);  and  the  steps  used  when  35  is  2 are  carried  out. 
Upon  returning  from  the  machine  language  program  of  appendix 
0,  the  program  counter,  registers  and  stack  pointer  are 
assembled  and  outputted  as  the  variable  LP  dictates.  If  35 
is  2,  then  the  machine  language  program  is  over  (one  more 
return  than  calls) . An  end  of  execution  message  is  printed 
on  the  video  display  and  the  monitor  program  is  loaded  and 
executed.  If  35  is  1,  then  one  is  added  to  iC.  If  K is 
greater  than  9 (i.e.  ten  lines  of  output  has  been 
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generated) , then  the  program  loops  to  single  step  execution 
program  1.  If  K is  less  than  or  egual  to  9,  then  the 
program  loops  to  single  step  execution  program  2. 


Figure  5 shows  a flow  chart  of  the  single  step 
execution  programs.  The  nested  operation  of  these  programs 
takes  twenty  seconds  of  real  time  to  execute  one  step.  This 
gives  the  operator  plenty  of  time  to  anticipate  the  changes 
which  each  step  will  make  to  the  registers.  For  an 
experienced  operator,  it  is  far  too  long  to  wait  for  the 
next  step.  For  that  case  using  a hardcopy  output  is 
suggested. 

6.  Disk  Storage  Mode 

To  start  the  disk  storage  mode  program,  Appendix  P, 
from  the  monitor  program  type  DSTORE,  then  press  ENTER  when 
the  mode  is  reguested.  This  program  will  store  a machine 
language  program  on  the  disk.  Even  more  generally,  it  will 
store  any  portion  of  memory  on  any  disk,  if  more  than  one 
disk  is  connected  to  the  system. 

The  operator  must  provide  a starting  memory  address 
in  decimal,  an  ending  memory  address  in  decimal,  and  a 
filename.  Reference  6 is  the  source  for  information  on  the 
optional  parameters  for  filenames.  The  simplest  filename  is 
a name  of  no  more  than  eight  alpha-numeric  characters.  The 
data  is  stored  under  the  filename,  tnerefore  an  easily 
remembered  filename  should  be  used.  The  program  stores  the 
data,  reminds  the  operator  of  the  filename  in  use,  and  then 
loads  and  executes  the  monitor  program. 
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7 .  Disk  Recall  Mode 
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To  start  the  disk:  recall  mode  ^program,  Appendix  2, 
from  the  monitor  program  type  DRECALL,  then  press  ENTER  when 
the  mode  is  requested.  This  program  will  load  a machine 
language  program  into  memory  from  a data  file  on  the  disk 
created  by  the  DSTORE  program. 

The  operator  must  provide  a starting  memory  address 
in  decimal,  an  ending  memory  address  in  decimal,  and  the 
filename  of  the  data  file  used  during  DSTORE  to  create  the 
file.  After  the  machine  language  program  is  loaded,  the 
operator  is  reminded  which  memory  locations  have  been 
loaded.  The  monitor  program  is  now  loaded  and  executed. 


8.  Tape  Storage  Mode 


To  start  the  tape  storage  mode  program.  Appendix  R, 
from  the  monitor  program  type  TST0H2,  taen  press  ENTER  when 
the  mode  is  requested.  This  program  will  store  a machine 
language  program  on  the  tape  recorder. 


The  operator  must  provide  a starting  and  ending 
memory  address  in  decimal.  The  tape  recorder  must  be  on  and 
set  to  record.  There  is  no  filename  for  the  tape  recorder 
storage  in  this  application,  so  remember  the  starting  and 
ending  tape  counter.  The  data  is  stored  on  the  tape, 
sixteen  bytes  at  a time.  After  the  data  is  transferad  to  the 
tape,  the  monitoc  program  is  loaded  and  executed. 


9.  Tape  Recall  Mode 
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To  start  tha  tapa  recall  mode  program,  Appendix  S, 
from  the  monitor  program  type  TRECALL,  then  press  ENTER  whan 
tha  mode  is  requested.  This  program  will  load  into  the  RAM 
memory  a machine  language  program  which  has  been  stored  on 
the  tape  using  TSTORE  mode. 

The  operator  must  provide  a starting  and  ending 
memory  address.  The  program  expects  the  operator  to  place 
the  tape  recorder  in  play  at  about  tha  starting  tape  counter 
used  in  the  TSTORE  mode.  After  the  data  is  loaded  in  the 
RAM,  the  monitor  program  is  loaded  and  executed. 
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C.  SPECIAL  CONSIDERATIONS  FOR  MACHINE  LANGUAGE  PROGRAMMING 


Most  systems,  which  support  machine  language 
programming,  have  peculiarities  of  which  a programmer  can 
take  advantage.  As  presently  configured,  this 
microprocessor  development  system  has  several  paouliarties. 
There  is  only  3K  of  protected  RAM  for  machine  language 
usage.  There  is  a IS  video  RAM  which  might  be  utilized. 
There  is  an  expan? ‘on  port  to  which  hardware  may  be  added. 
There  is  a memory  mapped  keyboard  which  can  be  used.  There 
is  the  possibility  of  using  the  subroutines  of  the  level  II 
basic  ROM  as  macro  instructions. 

The  3K  of  protective  RAM,  memory  addresses  7430  to  7FFF , 
is  available  for  «achine  language  programs,  a stack,  and,  as 
required,  for  storage  of  data.  The  machine  language  program 
resident  in  this  portion  of  RAM  is  not  relocatable  to 
another  section  of  the  RAM.  If  a large  amount  of  stack 
space  is  required,  a program’s  integrity  may  be  in  jeopardy. 
When  the  RAM  is  expanded  to  48K,  none  of  the  current 
software  will  support  the  use  of  the  additional  32K  of  RAM. 
The  PEEK  and  POKE  instructions  require  a different  syntax  in 
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the  supporting  basic  programs.  The  PEEK  syntax  in  the  first 
16K  of  RAM  is  PEEK  (address) . The  PEEK  syntax  for  tha  HAM  in 
the  expansion  interface,  at  memory  addresses  above  32767,  is 
PEEK (-1*address-32676) . To  PEEK  at  address  40000  tha 
instruction  would  be  PEEK (- 1*7233) . this  limitation  in  tna 
support  software  will  not  prevent  the  programmer  from  using 
this  additional  memory  as  a stack  or  data  storage  by  a 
machine  language  program. 

There  is  IK  of  video  RAM,  memory  locations  3C30  to  3FFF, 
which  can  be  used  for  several  purposes.  It  is  used  in  the 
example  labs  as  a indicator  light.  By  loading  BFhax  into  a 
video  address  the  video  location  is  whited  out.  This  can 
take  the  place  of  a single  hardware  LSD.  The  ASCII 
character  codes  and  video  codes  which  are  available  are 
given  in  appeadix  C of  Ref.  5.  The  video  HAM  may  be  used 
for  the  stack  if  required.  Ose  of  tha  video  RAM  is  limited 
to  applications  which  will  not  interfere  with  the  THS-80's 
use  of  the  video  HAM.  For  example,  the  programmer  would  not 
find  the  video  HAM  useful  for  a stack  during  a single  step 
execution  with  output  to  the  video  display.  However,  the 
stack  could  use  the  video  RAM  during  single  step  execution 
if  output  was  to  the  printer.  The  second  example  lab  does 
use  the  video  RAM  during  a single  step  execution  with  output 
to  the  video  display. 

The  use  of  the  expansion  port,  called  the  screen  printer 
port  on  the  expansion  interface,  will  be  useful  for  hardware 
projects  which  would  otherwise  require  a dedicated  Z-80  CPU. 
Figure  22  of  Ref.  1 is  a detailed  description  of  the 
expansion  port  edge  connecter.  In  general,  each  line  of 
this  edge  connector  wiLL  drive  only  one  ITL  load. 
Therefore,  drivers  or  tri-state  buffers  will  be  required  for 
an  external  hardware  project.  The  five  volt  power  supply, 
pin  39,  has  been  modified  to  show  a ground. 


The  use  of  the  keyboard  and  other  ROM  subroutines  will 
add  a considerable  dimension  to  machine  language 
programming.  At  present.  Ref.  9 is  the  sole  source  for  ROM 
subroutine  memory  locations.  In  tae  future,  the  Naval 
Postgraduate  School  will  have  a complete  listing  of  ROM 
subroutines  for  the  programmer  to  utilize. 


D.  USING  THE  DEVELOPMENT  SYSTEM 


The  learning  curve  is  a substantial  barrier  to  the  use 
of  any  new  product  or  device.  The  same  is  true  for  any  Z-80 
based  system  or  project  or  the  development  system  used  to 
create  the  required  software.  To  have  a system  of  basic 
language  programs  which  are  described  as  a microprocessor 
development  aid  for  the  Z-80  is  not  enough.  A developer 
must  have  confidence  in  the  system  and  must  be  heLped  to  get 
past  the  largest  part  of  the  learning  curve.  Appendices  X, 
Y,  and  Z are  designed  as  training  sessions  to  help  a new 
developer  to  learn  the  system,  to  develop  confidence  in  the 
system's  ability  to  solve  his  problem,  and  to  start  with 
small  successes  on  which  larger  projects  can  be  built. 


1 . Lab  1. 


Appendix  X,  lab  1,  first  contains  a vary  detailed 
power  up  procedure.  The  system  has  six  power  cords,  three 
edge  connector  cables,  three  connecting  cables,  and  one 
RS-232  connecting  cable.  The  sequence  of  powering  up  is 
important  and  should  be  followed  each  time  by  the  operator. 
There  are  many  other  capabilities  of  the  TRS-80 
microcomputer  system.  The  operator  should  refer  to  Refs.  5 
and  6 when  these  other  capabilities  are  required. 
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operations  which  will  retrieve  a machine  language  program 
resident  on  the  mini  disk  and  places  it  in  the  protective 
portion  of  the  RAM  using  the  disk  recall  mode.  The  contents 
of  the  RAM  is  verified  using  the  dump  mode.  This  program  is 
modified  by  the  load  mode  and  executed  by  the  execute  mode. 
The  program  uses  the  video  RAM  as  an  output  and  whitens  the 
first  256  video  RAM  locations. 

The  return  at  the  end  of  the  program  which  exists 


without  a call  is  a signal  to  the  TRS-80  to  exit  this 
machine  language  program  and  return  to  the  basic  language 
program.  All  programs  written  for  this  system  must  use  an 
ending  return.  This  return  should  be  removed  when  the 
program  is  used  in  a stand  alone  Z-80  system. 


At  the  end  of  lab  1,  the  operator  is  expected  to 
understand  the  start  up  procedure,  what  is  done  by  the 
monitor  program,  and  how  some  of  the  modes  work.  He  should 
examine  the  machine  language  program  at  the  end  of  this  lab 
to  gain  an  appreciation  for  what  the  program  is 
accomplish! ng. 


Lab  2,  Appendix  l,  builds  on  the  experience  of  lab 
1.  A more  complicated  machine  language  program  is  used  to 
demonstrate  the  use  of  the  single  step  execution  mode. 
There  are  four  levels  of  calls  during  this  program.  The 
video  memory  location  3PP9  is  used  as  an  L2D  and  follows  the 
line  of  registers,  which  produced  it,  up  the  video  display 
as  the  video  display  scroLIs.  When  the  machine  language 
program  of  lab  2 is  single  step  executed  using  line  printer 
output,  the  video  memory  location  is  lit,  but  not  scrolled. 
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The  operator  is  to  obtain  an  appreciation  for  the 
debugging  potential  of  the  single  step  execution  mode  of 
operation.  He  should  also  notice  the  absence  of  the  prime 
registers  from  the  single  step  execution  printout.  If  the 
programmer  requires  the  use  of  both  sets  of  Z-9D  registers, 
then  he  must  change  the  pcogram  for  it  will  not  execute 
properly  using  the  single  step  execution  mode. 

3.  Lab  3 

Lab  3, Appendix  Z,  is  a structured  example  of  tna 
system's  use.  Phe  operator  should  begin  this  lab  with  a 
machine  language  program  to  debug.  If  the  operator  fails  to 
write  his  own  program,  then  a short  program  can  be  found  at 
the  end  of  the  lab  for  this  purpose.  At  the  end  of  this  lab 
the  operator  will  have  operated  all  of  the  microprocessor 
development  system.  He  has  passed  the  largest  portion  of 
the  system's  training  curve  and  is  ready  to  use  the  system 
for  his  own  software  development. 
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V.  CONCLUSIONS  AND  RECOMMENDATIONS 


What  was  demonstrated  with  the  preceediag  is  that  an 
inexpensive  microcomputer  system  can  be  programmed  to 
parfora  aany  of  the  fanctions  of  a dedicated  aicroprocessor 
development  systea  costing  up  to  tea  tines  as  auch.  Speed 
of  operation  was  sacrificed  for  the  ease  of  programming. 
The  use  of  Badio  Shack's  disk  basic  language  is  aore  than 
adequate  to  support  this  Z-80  software  development  system. 
The  housekeeping  operations,  which  are  common  to  development 
systems,  are  general  enough  to  support  any  other 
microprocessor  development  system. 


A.  FUTURE  SOFTWARE 


The  software  future  of  the  TRS-30  aicrocomputer  system 
is  limited  only  by  the  ideas  implemented  with  it.  To 
support  the  2-80  Radio  Shack  has  distributed  two  software 
packages.  T-BU3,  Ref.  9,  is  a machine  language  program  that 
will  load,  store  on  tape,  dump,  and  execute  with  or  without 
breakpoints.  The  TRS-30  Editor/Assembler,  Ref.  10,  is  a 
machine  language  prograi  that  will  edit  and  assemble 
assembly  language  Z-80  programs.  These  machine  language 
programs  both  take  advantage  of  the  basic  ROM's  subroutines. 
A major  disadvantage  of  these  programs  is  that  they  cannot 
be  used  with  the  TRS-80  disk  basic  language.  To  improve 
this  Z-80  microcoapitec  development  aid,  a basic  language 
program  to  relocate  the  T-BUG  and  Editor/Asseabler  machine 
language  programs  to  a portion  of  memory  which  is  not  used 
by  disk  basic  is  necessary  to  allow  the  use  of  these 
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programs  with  disk  basic. 

& list  of  basic  SOM  subroutines  which  could  be  used  as 
4 macro  instructions  in  other  machine  language  programs  would 

add  a new  dimension  to  programming.  To  obtain  these 

subroutines  will  require  a disassembler  program  and  a lot  of 

i Kj 

bookkeeping. 

i I 

To  expand  the  TEKTRONIX  8002  to  include  additional 
microprocessors  will  cost  about  two  thousand  dollars  per 
additional  microprocessor.  The  software  required  for  the 
TBS-80  to  support  additional  microprocessors  will  ha/e 
little  direct  cost.  To  expand  the  THS-80  to  include 

development  systems  for  microprocessors  already  supported  by 
the  TEKTRONIX  8002  is  not  a time  effective  proposal.  The 
software  for  the  TBS-80  should  be  expanded  to  include 
INTEL'S  8748  microprocessor  family.  The  8748  microprocessor 
i has  the  greatest  potential  for  class  project  work.  A 

development  system  for  this  family  of  microprocessors  will 
go  a long  way  to  ease  the  burden  of  software  development  for 
the  8748. 

i 

3.  FUTOBE  HARDWARE 


There  are  several  cost  effective  hardware  additions  to 
the  TBS-80  microcomputer  which  will  support  a microprocessor 
development  system.  An  Interface  between  the  TBS-80  and  the 
TEKTBONIX  3002  will  provide  an  expanded  disk  capability,  the 
sharing  of  an  additional  54K  of  BAM,  and  the  use  of  a PROM 
programmer.  An  interface  between  the  TBS-30  and  the 
prompt-48  will  provide  additional  hardware  for  a 8748 
microprocessor  development  system.  The  use  of  the 
prompt-48's  PBOM  programmer  and  execution  with  or  without 
breakpoints  will  relieve  some  of  the  hardware  requirements 
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foe  such  a system.  An  interface  between  the  TRS-80  and 
IBM  360  will  add  mass  storage  capability  to  any  system. 


There  are  several  new  PROMs  and  at  least  one  old  PBOM 
which  are  not  supported  by  the  equipment  available  in  the 
microcomputer  lab.  The  TRS-80  with  its  basic  language 
capability  would  be  a logical  choice  of  systems  to  expand  to 
support  these  PROMs.  A class  project  could  be  directed 
toward  one  PROM  or  a family  of  PROMs. 
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APPENDIX  A 

THE  PHOCEDOEE  FOa  THE  CO  NVEB  SION  TO  LEVEL  II  3ASIC  FEOH 

LEVEL  I BASIC 

1.  Open  CPU/keyboard  cabinet. 

2.  Eemove  Level  I basic  BOM*  s from  sockets  Z33  and/or 
Z34. 

3.  Plug  in  the  24  pin  header  of  the  EON  board  to  Z33  or 
Z34  (Z33  is  recommended)  . 

4.  Attach  the  BOH  board  to  the  etched  side  of  the  CPD 
board . 

5.  Eeplace  DIP  shat  X3  with  the  new  DIP  shat. 

6.  Check  the  color  code:  yellow  (All),  red  (A12),  orange 
(A  13)  , green  (BOM*)  . 

a.  Solder  the  yellow  wire  to  pin  5 of  Z37. 

b.  Solder  the  red  wire  to  pin  13  of  Z21. 

c.  Solder  the  orange  wire  to  pin  3 of  Z21. 

d.  Solder  the  green  wire  to  pin  8 of  X3. 

7.  Close  CPO/keyboard  cabinet. 


I 
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APPENDIX  B 

THE  87  4-8  PROGRAM  TO  GENERATE  A LINS  PEED 


MEM  LOC 

HEX  CODE 

MNEMONIC 

000 

04 

JMP 

001 

05 

002 

00 

NOP 

003 

04 

JMP 

004 

28 

005 

B8 

MOV  R0,44 

006 

44 

007 

B9 

MOV  R1 , 7P 

008 

7F 

009 

BA 

MOV  R2,0D 

00  A 

OD 

OOB 

BB 

MOV  R3 , OA 

OOC 

OA 

00D 

00 

NOP 

OOE 

00 

NOP 

OOP 

00 

NOP 

COMMENTS 

Power  Dp  Restart 


Interrupt  Vector 
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HEM  LOC 

HEX  CODE 

MNEI  DNIC 

COMMENTS 

010 

23 

MOV  A,  0 1 

Oil 

01 

012 

3A 

0 UTL  P2  , A 

Hi-Z  on  DS  (not)  fcoa  8748 

013 

00 

HOP 

014 

23 

MOV  A,  FF 

015 

PF 

016 

39 

0 UTL  PI  t A 

Enabias  PI  foe  OR's  and 

AND's  (not  necessary  in  this 

Application) 

017 

00 

NOP 

018 

81 

MO VX  A, HI 

Places  BOS  in  Hi-Z  State 

019 

00 

NOP 

01A 

75 

ENT3  CLK 

Makes  TO  a clock  at  1/3 

The  8748  Clock 

0 IB 

05 

EN  I 

Enable  Interrupt 

01C 

00 

NOP 

0 ID 

00 

NOP 

0 1 E 

00 

NOP 

01P 

00 

NOP 

HEM  LOC 

HEX  CODE 

MNEMONIC 

COMMENTS 

020 

00 

NOP 

021 

P8 

MOV  A, HO 

48 


02  2 


39 


■■ 


1 


0 OTL  PI, A En a b La  8212  and  Enable 
TRS-80 


023 

04 

JMP 

Loop  to  020  Until 

Interrupted 

024 

20 

025 

00 

HOP 

026 

00 

MOP 

027 

00 

MOP 

028 

23 

BOV  A, 56 

An  Interrupt  has  Occurred 

029 

66 

02A 

39 

OUTL  PI , A 

stop  ras-80 

02B 

08 

IMS  A, BOS 

Input  Last  Character 

02C 

59 

AML  A f R 1 

Insure  Character  is  7 Bits 

020 

DA 

XRL  A, R2 

Chacic  Last  Character 

for  Carriage  Return 

02E 

00 

MOP 

02F 

00 

MOP 

BEB  LOG 

HEX  CODE 

B NEB  0 NIC 

COMMENTS 

030 

96 

JMZ 

If  Mo  Carriage  Return  Start 

End  Interrupt  Sequence 

031 

41 

032 

00 

MOP 

033 

86 

JNI 

Loop  to  032  Ontil  E0C=1 

49 
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i 1 


IT  . 


From  0 ART 


035 

00 

NOP 

036 

23 

MOV  A, 33 

037 

33 

033 

39 

OOTL  PI,  A 

Disable  8212 

039 

FB 

MOV  A, S3 

03A 

02 

OOTL  BOS, A 

Place  OA  on  BOS  for 

A Lina  Faed 

033 

23 

MOV  A, 00 

03C 

00 

03D 

3A 

OOTL  P2 , A 

P2  is  Low  to  Start 

The  Strobe  to  0A8T 

03E 

23 

MOV  A, 1 1 

03F 

11 

MEM  LOC 

HEX  CODE 

MNEMONIC 

COMMENTS 

040 

3A 

OOTL  P2,A 

End  of  Strobe  to  0A3T 

041 

81 

MOVX  A , 8 1 

Place  BOS  in  Hi-2  State 

04  2 

00 

NOP 

043 

86 

JNI 

Loop  to  042  Ontil  E0C=1 

044 

42 

045 

00 

NOP 

046 

46 

JT1 

Jump  to  04  a When  Printer 

50 

APPENDIX  C 

MONITOR  PROGRAM 

500  ' MONITOR:  A Z-80  MICROPROCESSOR  DEVELOPMENT  AID  FOR 
DISK  BASIC  ON  THE  TRS-80  31  DF  CORTEVILLE  APR  79 

501  DEFSTR  A-B 

502  PRINT  "MONITOR  PROGRAM" 

504  PRINT  "A  Z-80  MICROPROCESSOR  DEVELOPMENT  AID" 

506  INPUT  "SHORT  OR  LONG  EXPLANATION?  INPUT  S OR  L";A 

508  IF  A="S"  PRINT  " DUMP , LOAD , EXEC , 3 S EXEC, TSTORE, TR ECALL, 
DSTORE,D RECALL, END ,L" 

510  IF  A = " S " INPUT  "MODE"; 3 

512  IF  A="S"  GOTO  534 

514  PRINT  "INPUT:  DUMP,  TO  EXAMINE  MEMORY  LOCATIONS" 

516  PRINT  "INPUT:  LOAD,  TO  ENTER  PROGRAM  INTO  MEMORY" 

518  PRINT  "INPUT:  EXEC,  TO  RUN  A PROGRAM" 

520  PRINT  "INPUT:  SS  EXEC,  TO  SINGLE  STEP  THROUGH  A PROGRAM" 

522  PRINT  "INPUT:  DSTORE,  TO  STORE  A PROGRAM  ON  T3E  DISK" 

524  PRINT  "INPUT:  DRECALL,  TO  RETRIEVE  A PROGRAM  STORED  ON 

THE  DISK" 

526  PRINT  "INPUT:  TSTORE,  TO  STORE  A PROGRAM  ON  THE  TAPE 
RECORDER" 

528  PRINT  "INPUT:  TRECALL,  TO  RETRIEVE  A PROGRAM  STORED  ON 


52 


THE  TAPE  RECOEDED" 


530  PRINT  "INPUT:  END,  TO  EXIT  THIS  DEVELOPMENT  AID" 

' 

532  INPUT  B 

\ I 

534  IF  3="DUMP"  RUN  "DUMP/BAS. DFC: 0" 
h 536  IF  B="LO AD"  RUN  "LOAD/BAS. DFC: 0" 

I 

| 

j 538  IF  B="EXEC"  RUN  "EXEC/BAS. DFC: 0" 

i I 

540  IF  B="SS  EXEC"  RUN  "3 5 E XEC/3 AS . DFC : 0" 

542  IF  B="DSTORE"  RUN  "DSTORE/BAS. DFC: 0" 

544  IF  B="DRECALL"  RUN  "DR EC  ALL/BAS.  DFC : 0 " 

! 

* 

546  IF  B="TSTORE"  RUN  "T5T0RE/BAS. DFC: 0" 

548  IF  S="TRECALL"  RUN  "T REC ALL/BAS. DFC:0" 

i 

■ 

| t 

lj  550  IF  B="L"  GOTO  514 

I 

552  IF  B= "END"  END 

: 

554  A="S":GOTO  508 


APPENDIX  D 

DUMP  PROGRAM 

5 'DUMP:  A PART  OF  A Z-80  MICROPROCESSOR  DEVELOPMENT  AID  FOR 
DISK  BASIC  ON  THE  TRS-80  3Y  DF  CORTEVILLS  APR  79 

10  CLEAR  300 : DEFST  R A- B: DE  FI  NT  I-N 

15  PRINT  "DUMP  MODE" 

20  INPUT  "INPUT  STARTING  MEMORY  LOCATION  IN  DECIMAL"; N1 
25  INPUT  "INPUT  NUMBER  OF  MEMORY  LOCATION  IN  DECIMAL" ;N2 
30  PRINT  "IS  OUTPUT  VIDEO  OR  FOR  THE  LINE  PRINTER?" 

35  INPUT  "INPUT  V OR  LP";  A 
<40  N3=N1 

44  B1  = STR$(N1) 

45  N = N1  : 0=4  : GOSUB  100:B1*BH-»  " + B 
50  FOR  K=1  TO  16 

55  N=PEEK  (Ml) :0=2:G0SUB  100:B1=B1+"  " + B:N1  = NH-1 
65  NEXT  K 

70  IF  A="V"  PRINT  B1 
75  IF  A=" LP"  LPRINT  B1 
80  IF  NKN3+N2  GOTO  44 

85  IN  PUT  "CONTINUE  DUMPING  (YES  OR  N3)";B 

90  IP  B= "YES " THEN  20  ELSE  RUN  "MONITOR/BAS. DFC: 0" 
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APPENDIX  E 

\ ' 

LOAD  PROGRAM 

4  i 
* 

: 

» 

i \ 

5 'LOAD:  A P AST  OF  A Z-80  MICROPROCESSOR  DEVELOPMENT  AID  FOR 
DISK  BASIC  ON  THE  TRS-80  B I DF  CORTEVILLE  APR  79 

6 GOTO  300 

i 

300  DEFINT  I-0:DEPSTR  A-B 

I 

1 

' 305  PRINT  "LOAD  BODE" 

310  INPUT  "INPUT  STARTING  MEMORY  LOCATION  IN  DECIMAL"; N1 

I 

i 

315  PRINT  "OUTPUT  IS  VIDEO  - USE  QUIT  TO  STOP  LOADING" 

I 320  N=N 1 : 0=4 : GO SOB  100:B1=B 

325  N=PEEK(N1)  :0=2;G0SUB  100:B2  = B 
330  B3=B 1 ♦"  "+B2: PRINT  B3: INPUT  B 

335  IF  3="Q0IT"  GOTO  350 

336  IF  B="'»  GOTO  345 
340  GOSUB  20 0: POKE  N1,N 
345  N 1=N  1 + 1 : GOTO  320 

350  RON  "MONITOR/BAS. DFC:  0" 
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600  • EXECUTION:  A PART  OF  A Z-80  MICROPROCESSOR  DEVELOPMENT 
AID  FOR  DISK  BASIC  ON  THE  TRS-80  BY  DF  CGRTEVILLE  APR  79 

J ■ 

! 605  DEFSTR  A-B: DEP INT  1-0 

j | 

610  PRINT  "EXECUTION  NODE" 

*-  B 

615  INPUT  "INPUT  STARTING  MEMORY  LOCATION  IN  DECI3AL";N1 

! 

| 620  N=N 1 ; 0=4 :GOSUB  100:PRINT  "EXECUTION  BEGINS  AT  » , B 

625  DEFUSR0=N1 

630  PRINT  USR0(0)i  " END  EXECUTION" 

[ 

635  INPUT  "CONTINUE  EXECUTION  NODE  (YES  OR  NO) " ; B 
640  IF  B="YES"  THEN  610 
645  RUN  "NON ITOR/B AS . DFC; 3 " 
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APPENDIX  G 


SINGLE  3PEP  EXECUTION  PROGRAM 


1300  *SS  EXEC:  A PAST  OP  A Z-80  MICROPROCESSOR  DEVELOPMENT 
AID  FOR  DISK  BASIC  ON  THE  IRS-30  BX  DP  CORTEVILLE  APR  79 

1305  DEPINT  I-N : DIM  I(19):DEFSTR  A-B 

1310  I (0 ) = HED:  I < 1)  = H73:  1(2)*  HCO:  I (3)  = H73:  I(4)  = H3  1 : 
1(5)  = HC2:  1(6)  = H73:  I (7)  = HC1 : I (3)  = HD1 : 1(9)  = HE  1 ; 
I(10)  = HF1 : 1(11)*  HDD:  I ( 1 2) = HE1 : 1(13)  = HFD:  I(14)  = HE1 : 

1(15)*  HED:  1(16)  = H7B:  I ( 1 7)  = HCE : I ( 18)  = H73:N=0 

1315  FOR  N2=  29653  TO  29671 

1320  POKE  N2,I(N)  :N*N+1 

1325  NEXT  N2 

1330  1 (2)*  HCE:  I (5)  * HCE:  I (7)  = HFD:  1(8)*  HE5 : 1(9)*  HDD: 

1(10)*  HE5:  1(11)  = HP5  : I ( 1 2)  = HE5  : 1(13)*  HD5:  I(14)=  HC5: 

1(17)*  HCO:  1(19)*  HC9:  51  = 0 

1335  FOR  N2=29676  TO  29695 

1340  POKE  N2,I(N)  : N=N+1 

1345  NEXT  N2 

1350  PRINT  "IS  OUTPUT  POR  VIDEO  OR  LINS  PRINTER" 

1355  INPUT  "INPUT  V OR  LP«;A 
1360  IF  A*"V»  POKE  29648,0 
1365  IP  A="LP"  POKE  29648,1 
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1370  INPUT  "STARTING  MEMORI  LOCATION  IN  DECIMAL" ; S 


APPENDIX  3 


SINGLE  STEP  EXECUTION  PROGRAH  1 

1 ' SS EXE Cl /BAS. DFC : 0 

1400  DEPSTR  A-B:  DEFINT  1-2 

1405  POKE  29649,0 

1410  K 1=  (PEEK  ( H73D0)  AND  HOI) 

1415  A="PC  FABCDEHLSP 

1420  IF  K 1=0  PRINT  A 

1425  IF  K1= 1 LPRINT  6 

1430  RON  "SS EXEC2/BAS . DFC : 0 " 


SINGLE  STEP  EXECUTION  PROGRAM  2 


1 * SSSXEC2/B  AS . DFC :0 

2 DEPSTR  A- B: DEPINT  I-Q 

6 FOR  K1  = 29672  TO  29675 

7 POKE  K1,0 

8 NEXT  K 1 

9 N 1=25  6*PEEK  (2965 1) +PEEK (29650)  :GOIO  27 

27  H=PEEK  (N1)  :N=M/16  :GOS(JB  10:31=B 

28  N=M-N*16:  GOSOB  10:B2=B 

29  IP  (31="4M  OR  B 1 =H  5 '•  OR  B 1 = **5 *•  OR  31="7"  OR  B1="8"  OR 
B1  = »9"  OR  B1  =" A"  OR  B1="B")  GOTO  70 

30  IP  B2="6 " OR  B2="E"  GOTO  71 

31  IP  8 2 = " 1 " AND  B1  = 0"  GOTO  72 

32  IP  B 1 =,,0"  GOTO  70 

33  I?  B1="1"  AND  B 2="0  " GOTO  71 

34  IP  B1  ="1 " AND  82="  1 " GOTO  72 

35  IP  B 1 = " 1 " AND  B2="8"  GOTO  71 

36  IP  B1="1"  GOTO  70 

37  IP  B1  = "2'*  AND  (B2="  1”  OR  82="2")  GOTO  72 

38  IP  B2="2"  GOTO  72 
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39 

IF 

B1="2" 

AMD 

B2=" 8" 

GOTO 

71 

40 

IF 

B2="A" 

GOTO 

72 

41 

IF 

B1='*2" 

AMD 

B2=w 0M 

GOTO 

71 

42 

IF 

B1 ="2" 

GOTO 

70 

43 

IF 

B1 ="3" 

AMD 

B2=”0" 

GOTO 

71 

44 

IF 

B1="3" 

AND 

B2="1" 

GOTO 

72 

45 

IF 

bi="3" 

AMD 

B2=»8" 

GOTO 

71 

46 

IF 

B1  ="3" 

GOTO 

70 

47 

IF 

B2  =''4  " 

OB  B2=',Cn  GOTO 

72 

48 

IF 

B1 ="C" 

AMD 

B2='*3" 

GOTO 

72 

49 

IF 

B1='»CW 

AND 

B2="B" 

GOTO 

71 

50 

IF 

B1="C" 

AND 

B2="D" 

GOTO 

72 

51 

IF 

ai=«D" 

AND 

B2="3" 

GOTO 

71 

52 

IF 

B1="D" 

AND 

B2="B" 

GOTO 

71 

53 

IF 

B2="D" 

THEN 

54  ELSE  70 

54  M=PBEK(MH-1)  : M-H/16  :GOSCJB  10:B3=B 

55  N=tl*1 6 :G0 SOB  10:B4=3 

56  IF  B1="D"  GOTO  59 

57  IP  B1  = "E"  GOTO  66 

58  IF  B1="F"  THEM  59  ELSE  STOP 

59  IF  B3="C"  OB  B4="A'»  GOTO  73 

60  IF  (B3="2"  AMD  (B4="1»  OB  B4  = "2">)  GOTO  73 

62  IF  B3*"3»  AMD  B4="6"  GOTO  73 

63  IF  B3*"E"  OH  B4*"9"  GOTO  71 


61 


64  IP  B3="2"  AND  B4="3"  GOTO  71 


F 


65 

IF 

B3="2" 

AND  B4="B"  SOTO 

72 

66 

IF 

B3  = "A" 

OB  B3 

="3"  GOTO 

71 

68 

IF 

B4="B" 

GOTO 

73 

69 

IF 

B4="3" 

THEN 

73  ELSE  71 

70  HON  " SSEXEC3/BAS . DFCiO" 

71  BUN  " SSEXEC4/BAS. DFC: D " 

72  HUN  "SSEXEC5/BAS. DFC:D" 

73  BON  "SSEXEC6/BAS. DFC:0" 
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APPENDIX  J 


SINGLE  SrEP  EXECUTION  PROGRAM  3 


2  DEFSTR  A-B:  DEPINT  I-Q 


3  M4=PEEK  (29652)  :30SUB  33:POKE  29652,  M4 


4  N3=PEEK  (29648)  AND  1 


8 POKE  29648, M3 


30  H1=256*PEEK  (29551)  + PEEK  (29650)  : M = PEEK(N1):  N=S/16:  GOSUB 
10:  B1=B:  M=M-M*16:  GOSUB  10:  B2=B:  N= PEEK  (29640) 


34  IP  B1="C'»  OR  B1  ="D"  OR  B1="E"  OR  B1=*'P"  GOTO  49 


39  IP  B1="P"  AND  B2="0"  GOTO  54 


40  IF  B 1 = "C " AND  B2="8"  SOTO  55 


41  IF  B1="D"  AND  B2="8"  3DT0  56 

42  IF  B1="E"  AND  B2="8"  SOTO  57 

43  IF  B1="F"  AND  B2="8"  3310  58 

44  115=  Is  116=3  :RETURN 

45  M5=1:  M6=1 : POKE  296 7 2 , PEEK  (296 39 ) : 

29673 , PEEK (29638) : RETURN 

46  M4=M4+ 1 : IF  M4>1 27  THEN  47  ELSE  48 

47  H5=2: M6=1 :REIURN 

48  115  = 1:  115=1:  H = 256*PEEK  (2964  7)  + PEEK  (29546)  : 

29672, PEEK  (M  + 1)  : POKE  29673  , PEEK  (M)  : POKE  29674,51: 
29675,51:  RETURN 

49  PRINT  "YOU  HAVE  USED  A RST  ???  EMULATED  WITH  A NOP" 


50 

H5= 

1:1 

M6=2 

: RETURN 

51 

IF 

(» 

AND 

64  ) =64  THEN  50  ELSE  46 

52 

IF 

(» 

AND 

1 ) =1  THEN  50  ELSE  46 

53 

IF 

(N 

AND 

4 ) =4  THEN  50  ELSE  46 

54 

IF 

(» 

AND 

128) =128  THEN  50  ELSE  46 

55 

IF 

(H 

AND 

64  ) =0  THEN  50  ELSE  46 

56 

IF 

(N 

AND 

1 ) =0  THEN  50  ELSE  46 

57 

IF 

(M 

AND 

4 ) =0  THEN  50  ELSE  46 

58 

IF 

(M 

AND 

128)  =0  THEN  50  ELSE  46 

POKE 


POKE 

POKE 
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APPENDIX  K 

SINGLE  STEP  EXECUTION  PROGRAM  4 

1 ' SSEXEC4/B AS . DFC :0 

2 DEFSTH  A- B: DEF IN T I-Q 

3 M4=PEEK  (29652)  :GOSOB  30:POKE  29652,34 

4 N3=  (PEEK  (29648)  AND  1)  OR  2 

5 IF  M5=2 :M3~N3  OR  8 

6 IF  M6=2:N3=N3  OR  16 

7 IF  M6=3:N3=N3  OR  32 

8 POKE  29648, N3 

9 RON  "SSEXEC7/BAS  . D FC  : O'* 

30  N1  = 256*PEEK(29651)  +PEEK  (2  9650)  : M=P2EK(N1):  N=M/16:  GOSU3 
10:  31=8:  N=M-N*16:  GOSOB  10:  B2=B 

31  M=PEEK  (N1+1)  : N = M/16  :G0508  10 : B3=B: N=M-N* 1 6 : 30S03  10:34=8 

32  A 1=" YOU  ARE  USING  •* : A2  =••  THIS  WILL  BE  EXECUTED  ONTIL 
":=PEEK(  2964  0) 


33 

IF 

B1  = "1 " 

AND 

B 2='*  3 *• 

GOTO 

53 

34 

IF 

B 1 =,,3” 

AND 

B2="8" 

SOTO 

56 

35 

IF 

B 1 = **  3 " 

AND 

32="0" 

GOTO 

57 

36 

IF 

B 1 ="2" 

AND 

B 2="8" 

SOTO 

58 

37 

IF 

B1  = **2" 

aND 

B2="0 " 

GOTO 

59 

38  IF  B1="D"  AND  B2="D"  AND  B3  = "E''  AND  34="9"  SOTO  60 

39  IP  31="F"  AND  B2="D''  AND  B3="E  AND  B4="9"  GOTO  61 

40  IP  B1="1”  AND  B2="Q"  SOTO  62 

41  IF  B 1 ="E"  AND  32='*D"  T3EN  42  ELSE  75 

42  IF  33  = »'4"  AND  B2="D',  SOTO  65 

43  IP  B3="4"  AND  B2="5"  SOTO  66 

44  IF  B3<>"B"  GOTO  75 

45  IF  B4="0"  GOTO  67 

46  IF  B4="8"  GOTO  68 

47  IF  B4  ='*1 " GOTO  69 

48  IF  B4="9"  GOTO  70 

49  IF  B4="2"  GOTO  71 

50  IF  B4  = ,,A"  GOTO  72 

51  IF  a4  = ',3"  GOTO  73 

52  IF  34="B"  THEN  74  ELSE  75 

53  IF  PEEK  (N  1+  1)  >1  27  GOTO  55 

54  M1  = N1+PEEK(N1  + 1) +2: N=N1 /2 56: POKE  29672, N;  N=N 1 - N*256: POKE 
29673, N; M5=1  : 86  = 1:  RETURN 

55  N=256-PEEK(N1+1)  : N 1=N  1-N  + 2 : 3 5=  1 : 86  = 1 : N=N  1 /25  6 : POKE 
29672, N:  N=N  1-N*256: POKE  29673,  N:  RET'JSN 

56  IF  (I  AND  1 ) =0  THEN  76  ELSE  53 

57  IF  (I  AND  1 ) =1  THEN  75  ELSE  53 

58  IF  (I  AND  64) =0  THEN  76  ELSE  53 

59  IF  (I  AND  64) =64  THEN  75  ELSE  53 

60  85  = 1 : 86=1;  POKE  29672, PEEK  (29543)  : POKE 


29673, PEEK (29642) : RETURN 


60  85=1:  86  = 1 : POKE  2967  2,  PEEK  (2964 5)  : POKE 

29673, PE EK(296424:  RETURN 


62 

IP  (PEEK(29635) - 

1)  =0  THEN  63  ELSE 

54 

63 

POKE 

29674,5:85  = 

1:86=2 

: RETURN 

| 64 

POKE 

29674, 5:IF 

(PEEK  (N1  + 1)  AND  123)=128 

THEN 

55  ELSE 

: 65 

PRINT 

A1  ,"A  RET I 

???  S8ULATED  WITH  NOP": 

GOTO 

76 

66 

PRINT 

11,"  A RETN  ??? 

EMULATED  NITH  NOP" 

: GOTO 

76 

67 

: | 

PRINT 

A1,"  LOIR 

" , A 2 , " 

BC=0" : GOTO 

75 

1 68 

PRINT 

11,"  LDDR 

'M2," 

BC=0 " : GOTO 

75 

69 

PRINT 

A1  , " CP  IR 

" , A 2,  " 

BC=0" : GOTO 

75 

1 70 

PRINT 

A1,"  CP  DR 

" » A 2 , " 

BC=0"  -.GOTO 

75 

) 

71 

PRINT 

A1,"  INIR 

■M2," 

B=0": GOTO 

75 

72 

PRINT 

11,"  INDR 

" , A2,  " 

B=0" : GOTO 

75 

1 73 

PRINT 

A1  , " OTIR 

M2," 

B=  0" : GOTO 

75 

74 

PRINT 

A1,“  OTDR 

" » A 2 , " 

3=0": SOTO 

75 

75 

85=1: 

H6=3 : RETURN 

76 

85  = 1: 

86=2 : RETURN 

k— ...iL.  ■:  .<*&:**•  ' 


APPENDIX  L 


SINGLE  STEP  EXECUTION  PROGRAM  5 


1 1 SSEXEC5/B AS. DFC: 0 

2 DEFSTR  A-B:  DEFINT  I-Q 

3 H4=PEEK  (29652)  : GOSUB  30:POKE  29652, M4 

4 N3- (PEEK  (29648)  AND  1)  OR  4 
" 5 IF  H5=2  N3=N3  OR  8 

6 IF  M6  = 2 N3=N3  OR  16 

7 IF  116=3  N3=N3  OR  32 

8 POKE  29648, N3 

9 RUN  "SSEXEC7/BAS.DFC:0" 

30  Nl=256*PEEK  (29651)  ♦•PEEK  (29650)  : M=PSEK  ( N1)  : N=1/16:  GOSUB 
10:  B 1=B : N=H-N*16:  GOSUB  10:  B2  = B 

31  I=PEEK  (29640) 

32  IF  B2=«3"  GOTO  50 

33  IF  B1="CM  AND  B2="D"  GOTO  51 

34  IF  B1=«C"  AND  32="2"  GOTO  52 

35  IF  B1="D"  AND  B2=,*2"  GOTO  53 

36  IF  B1="E"  AND  32="2"  GOTO  54 

37  IF  B1=»»F"  AND  B2=«2W  GOTO  55 

38  IF  B1  = "C"  AND  B2="l"  GOTO  56 
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^ c " ' — 


39 

I? 

B1="0» 

AND 

B2=" A" 

GOTO 

57 

40 

IP 

SI  ="EM 

AND 

B 2=  " A '• 

GOTO 

53 

41 

IP 

B1  ="PM 

AND 

B2="A" 

SOTO 

59 

42 

IP 

ai="c" 

AND 

B2="4» 

GOTO 

60 

43 

IP 

B1="D" 

AND 

B2="4'» 

GOTO 

61 

44 

IP 

B1="E" 

AND 

B 2=  '*  4 " 

GOTO 

62 

45 

IF 

B 1 ="?" 

AND 

B2="4 " 

GOTO 

63 

46 

IP 

B1 =«cM 

AND 

B2="C" 

GOTO 

64 

47 

IF 

B1="D" 

AND 

B2=',C'* 

GOTO 

65 

43 

IP 

B1="E" 

AND 

B 2= " C ” 

GOTO 

66 

49 

IF 

B1='*P» 

AND 

B2="C" 

THEN 

67  ELSE 

50 

M5= 

= 1 : M6= 

1:  POKE  29672,  PEEK(N1  + 2> 

RETURN 


51  M4=M4— 1 : N=N1*3:  M=N/256:  N=N-M*256: 

M1=256*PEEK  (2964  7)  +PEEK  (2  9646)  :POKE  MI-1, M:  POSE  MI-2, N: 
POKE  29674,59:  POKE  29675,59:  GOTO  50 


52 

IP 

(I 

AND 

64  ) =64  THEN  71  ELSE  50 

53 

IP 

(I 

AND 

1 1 =1  THEN  71 

ELSE  50 

54 

IP 

(I 

AND 

4 ) =4  THEN  71 

ELSE  50 

55 

IP 

(I 

AND 

128)  =128  THEN 

71  ELSE  50 

56 

IF 

(I 

AND 

64  ) =0  THEN  71 

ELSE  50 

57 

IP 

(I 

AND 

1 ) =0  THEN  71 

ELSE  50 

53 

IP 

(I 

AND 

4 ) =0  THEN  71 

ELSE  50 

59 

IP 

(I 

AND 

128) =0  THEN  71 

ELSE  50 

60 

IP 

(I 

AND 

64  ) =64  THEN  71  ELSE  51 
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* 


61 

IP 

(I 

AND 

1 ) =1  THEN  71 

ELSE  51 

[ j 

• 

62 

IP 

(I 

AND 

4 ) =4  THEN  71 

ELSE  51 

I 

63 

IF 

(I 

AND 

128) =128  THEN 

71  ELSE  51 

• 

64 

IP 

(I 

AND 

64  ) =0  THEN  71 

ELSE  51 

l 

• 

• 

65 

IP 

(I 

AND 

1 ) =0  THEN  71 

ELSE  51 

1 

t 

• 

1 

66 

IP 

(I 

AND 

4 ) =0  THEN  71 

ELSE  51 

. 

• 

67 

IP 

(I 

AND 

128)  =0  THEN  71 

ELSE  51 

« 

\ 

70 

M5  = 

Is 

M 6=  3 

: RETURN 

! 

* 

71 

H5= 

Is 

116=2 

:EETURN 

\ 

I 


j 

{ 

; 

. 

i 


1 

i 


L 
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APPENDIX  N 


r? 


i 

i 

J 

I 

i 

i 

i 

i 

i 

i 

1 


SINGLE  SIEP  EXECUTION  PORGRAN  6 


1 ' SSEXEC6/B AS . DFC : 0 

2 DEPINT  N 

3 N3=  ( (PEEK  (29648)  AND  1)  OR  6)  OR  32 

4 POKE  29648, N3 

5 RUN  "SSEXEC7/BA5.D?C:0'» 


APPENDIX  N 


» 

i 


SINGLE  STEP  EXECUTION  PROGRAM  7 


i 


| 

i 

i 

t 

* 

> 

J 

I 


i 

i 

i 

i 


1 1 S3EXEC7/BAS. DFC :0 

2 CLfiAH  300 : DEFINT  I-QiDEPSTH  h- 3: DIB  A(16) 

4 K=PEEK  (29649) 

5 LP=PEEK  (29648)  AND  1 

6 N3=256*PEEK  (2965  1)  +PEEK (29650) 

8 IP  PEEK  (29672) <>0  THEN  N1=256*PEEK (29672) +PEEK (29673  * * 


ELSE  N1=N3 

10  I=PEEK  (29648) 

u 

if 

<i 

and 

»>#•  then  ms#2  else  a5*1 

16 

IP 

(I 

AND 

48)  *0  THEN  15  = 1 

18 

IP 

(I 

AND 

48) =16  THEN  36=2 

20 

IF 

(I 

AND 

48)  =32  THEN  36  = 3 

22 

IP 

(I 

AND 

6)  =0  THEN  N2  = 1 

24 

IP 

(I 

AND 

6)  =2  THEN  N2=2 

26 

IP 

(I 

AND 

6) =4  THEN  N2=3 

28 

IP 

(I 

AND 

6) =6  THEN  N2=4 

30 

POKE 

2967 2,0: POKE  29673,0 

32 

ON 

36 

GOTO  41,40,34 

72 


. 


34  FOR  K 1 *29 672  13  2967UN2 


36  POKE  K1 , PEEK  (HI)  :N1=N1*1 


38  NEXT  K 1 


40  N 1=N3+N2 

41  N=N 1/256:  POKE  29651, N:  N=N1-N*25b:  POKE  29650,N 

42  OEFOSBO-29653 : X=OSRO (3 ) 

44  N=N3:0=4:G0SUB  100:A(15)=B 
46  POE  K 1=0  TO  13 

48  N=PEEK  (29634+K1)  :O=2:3OS0B  1 00:  A (K1 +2)  =B 
50  NEXT  K 1 
52  POE  K 1=0  TO  13 
54  A (K1 ) -A(K1>2) 

56  NEXT  K1 

58  A (13)  =A(13) +A  (12)  :A(9»  = A(9)+A(8)  :A(11)=A(11)  *A(10) 

60  B=A ( 1 6)  ♦**  "+A(5)+"  "+A(7)+"  "+A(1)+"  "♦A(0)+"  " + A(3)+" 

"♦A  (2)  +'•  "♦A  (5)  ♦"  "+A  (4)  ♦"  "+A  ( 1 3)  +■"  ''+A(9)+"  " + A(11) 

62  IP  LP=0  PBINT  B 

64  IP  LP=1  LPBINT  B 

66  IP  N5v2  GOTO  70 

68  K=K* 1 : POKE  29649, K:  IP  K>9  THEN  BUN  "SSEXEC1 /BAS . DFC: 0" 
ELSE  BUM  "SSEXEC2/BAS. DFC: 0" 

70  PBINT  "END  OF  EXECUTION" 

72  BUN  "HONITOB/BAS. DFC: 3" 


APPENDIX  0 

SINGLE  STEP  EXECUTION  MACHINE  LANGUAGE  PROGRAM 


LOC  LOC 

HEX  CODE 

MNEMONIC  Comnants 

DSC  HEX 

29653  73D5 

ED73C073 

LD(an),SP  Save  the  basic 

language  sp 

29657  73D9 

31C273 

LD  SPrnn  Set  stack 

pointer 

29660  73DC 

Cl 

POP  BC 

29661  73DD 

D1 

POP  DE 

29662  73DE 

El 

POP  HL 

29663  73DP 

FI 

POP  AF 

29664  73E0 

DDE1 

POP  IX 

29666  73E2 

FDS1 

POP  IT 

29668  73E4 

ED7BCE73 

LD  SP(nn) 

73E8 


73E9 

73EA 

73EB 

29676  73EC  ED73CE73  LD(na),SP 


7a 


LOC 

LOC 

HE£  CODE 

HMEMOMIC 

;i 

'» 

DEC 

HEX 

\ 

29680 

73P0 

31CE73 

LD  SP,nn 

||  . 

29683 

73P3 

FDE5 

POSH  IX 

i 

i 

1 

, 1 

29685 

73P5 

DDE5 

POSE  IX 

; * 

| 

| 

29687 

73P7 

F5 

POSH  &F 

• 

29688 

73F8 

E5 

POSH  HL 

l i t 

\ 1 

2 9689 

73F9 

D5 

POSH  DE 

- I 

i 

» 

29690 

73,& 

C5 

POSH  3C 

) 

\ 

\\ 

, 

29691 

73PB 

ED7BC073 

LD  SP  (an) 

! 

29695 

73FP 

C9 

SET 

APPENDIX  P 


DSTOBE  PROGRAM 


700  'DSTOBE:  A PAST  OP  A 2-80  MICROPROCESSOR  DEVELOPMENT  AID 
POB  DISK  BASIC  ON  THE  TB5-80  BY  DP  CORTEVILLE  APR  79 

701  DEPSTB  A-BlDEPINT  1-0 

705  PRINT  "DSTOBE  NODE  - TO  STORE  A PROGRAM  ON  THE  DISK" 

710  INPUT  "STARTING  MEMORY  LOCATION  IN  DECIMAL" ; N 1 

715  INPUT  "ENDING  MEMORY  LOCATION  IN  0ECIMAL";N2 

720  INPUT  "INPUT  FILENAME  (NO  MORE  THAN  8 ALPHA-NUMERIC 
CHARACTERS  AND  ANY  OPTIONAL  PAR AMETERS)  " ; A 

725  OPEN  »0",1,A 

730  POR  N=N1  TO  N2 

735  PRINTtl , PEEK (N) 

740  NEXT  N 

745  CLOSE  1 

750  PRINT  "PROGRAM  DATA  IS  STORED  IN  ",A,"  NOTE  THAT" 

755  RUN  "MONITOS/B  AS . DPC : 0 " 


76 


it-  ^ 'W  .-2-- 


APPENDIX  3 

DRBCALL  PROGRAM 


800 

AID 

805 

310 

815 

820 

825 

330 

835 

840 

845 

850 

855 

860 

",N1 


' DSECALL:  A PART  OP  A Z-80  MICROPROCESSOR  DEVELOPMENT 

FOR  DISK  BASIC  ON  THE  TRS-80  BY  DP  CORTEVILLE  APR  79 

DEFSTR  A-B: DBF INT  N 

PRINT  "DRECALL  MODE  - TO  RECALL  A PROGRAM  FROM  THE  DISK” 

INPUT  “STARTING  MEMORY  LOCATION  IN  DECIMAL"; N1 

INPUT  "ENDING  MEMORY  LOCATION  IN  DECIMAL" ; N2 

INPUT  "FILENAME  AS  USED  DURING  DSIORE";A 

OPEN  "I" / 1 , A 

FOR  N=H1  TO  N2 

INPUTtl / N3 

POKE  NrN3 

NEXT  N 

CLOSE  1 

PRINT  "THE  PROGRAM  HAS  BEEN  LOADED  INTO  MEMOR f LOCATIONS 
TO  ",N2 


865  RUN  "MONITOR/BAS. DFC:0“ 


APPENDIX  R 

TSIORE  PROGRAM 

700 • ISTORE:  A PART  OF  A 2-80  MICROPROCESSOR  DEVELOPMENT  AID 
FOR  DISK  BASIC  ON  THE  TRS-80  BY  DF  CORTEVILLE  APR  79 

710  DEFSIR  A-B: DEP INT  I-N:DIM  1(15) 

720  PRINT  "TSTORE  MODE  TO  STORE  A PROGRAM  ON  TAPE  RECORDER 

*1" 

730  INPUT  "STARTING  MEMORY  LOCATION  IN  DECIMAL" ; N 1 

740  INPUT  "ENDING  MEMORY  LOCATION  IN  DECIMAL" ; N2 

745  PRINT  "NOTE  STARTING  TAPE  COUNTER  AND  TURN  ON  THE 
RECORDER  TO  RECORD" 

750  FOR  J=0  TO  15 

755  I(J)  =PEEK(N1)  : N1=N1+1 

760  NEXT  J 

765  PRINT#-1,I(0)  ,1(1)  ,1  (2)  ,1  (3)  ,1  (4)  ,1  (5)  ,1(6)  ,1(7)  ,1(8)  , 

1(9)  ,1(10), I (11)  ,1(12)  ,1(13)  ,1(14)  ,1(15) 

770  IF  N1<N2  GOTO  750 

775  PRINT  "NOTE  ENDING  TAPE  COUNTER" 

780  INPUT  "CONTINUE  TSTORE  MODS  (YES  OR  NO)";B 

785  IF  B="YES"  THEN  720  ELSE  RUN  "MONI TOR/BAS. DFC: 0" 


U 
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800  ' TRECALL:  A PAST  OF  A Z-80  MICROPROCESSOR  DEVELOPMENT 

AID  FOB  DISK  BASIS  ON  THE  TRS-30  BX  DF  CORTEVILLE  APR  79 

805  DEFSTR  A-B:  DEF INI  I-N:DIM  1(15) 

! 810  PRINT  "TRECALL  MODE  TO  RECALL  A PROGRAM  FROM  THE  TAPE 

J 

• RECORDER4' 

815  INPUT  "STARTING  MEMORX  LOCATION  IN  DECINAL" ; N 1 

* 
i 

820  INPUT  "ENDING  MEMORX  LOCATION  IN  DECIMAL"; N2 

825  PRINT  "TORN  ON  THE  TAPE  RECORDER  (PLAX)  AT  IHEST ARTING 

; 

COUNTER" 

830  INPUT  "WHEN  TAPE  IS  READY  PRESS  ENTER"; A 

850  INPUT#-1, 1(0), 1(1), 1(2), 1(3), 1(4), 1(5)  ,1(6), 1(7)  ,1(8)  , 

1(9)  ,1(10), I (11)  ,1(12)  ,1(13)  ,1(14)  ,1(15) 

855  FOR  J=0  TO  15 

860  IF  N1>N2  GOTO  870 

865  POKE  N1,I{J)  ;N1  = N1+1 

370  NEXT  J 

875  IF  N1>N2  THEN  850  ELSE  RON  "MONITOR/BAS. DFC: 0" 
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APPENDIX  I 

SUBROUTINE  10  DECIHAL  10  3 EX  CONVERSION 


i 


10 

IF 

N= 

0 

B="0W 

11 

IF 

N= 

1 

3=  "1" 

12 

IF 

N = 

2 

3=  "2” 

13 

IF 

N= 

3 

B=  "3" 

14 

IF 

N = 

4 

B='»4" 

15 

IF 

N— 

5 

B="5" 

16 

IF 

N = 

6 

B=  '*6 

17 

IF 

N= 

7 

B="7" 

18 

IF 

N = 

8 

3=h8" 

19 

IF 

N = 

9 

B=  "9" 

20 

IF 

N= 

10 

B="A'» 

21 

IF 

H= 

1 1 

B=,,B" 

22 

IF 

N= 

12 

B^C'* 

23 

IF 

N= 

13 

B="D" 

24 

IF 

N = 

14 

B=*'E" 

25 

IF 

N= 

15 

B=hF" 

26 

RETURN 

80 
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APPENDIX  U 


SUBROUTINE  100  DECIMAL  TO  HEX  CONVERSION 


110  a=16:M1=256:M2=4096:IP  0=4  GOTO  115 


105  IP  0=2  GOTO  120 


115  I (0)  =N/M2:N  = N-I  (0)  *M2  :I  (1)  =N/M1  ;N  = N-I  (1)  *M1 : 1 (2)  =N/M; 

1(3)  =N-I  (2)  *M;GOTO  130 

120  I (0)  =N/H  :I  (1)  =N-I  (0)  * M 

130  FOR  J=0  TO  0-1 

140  IF  I (J)  =0  A (J)  ="0" 

141  IP  I (J)  =1  A ( J)  =»  1" 

142  IP  I (J)  =2  A ( J)  ="2" 

14  3 IF  I (J)  =3  A (J)  =" 3 *’ 

144  IF  I (J)  =4  A ( J)  =" 4 " 

145  IF  I (J)  =5  A ( J)  ="  5 " 

146  IF  I (J)  =6  A ( J)  =" 6 " 

147  IF  I ( J)  = 7 A ( J)  ="7" 

148  IF  I (J)  =8  A ( J)  =" 8 " 

149  IF  I (J)  =9  A ( J)  ='•  9 n 

150  IF  I (J)  =10  A ( J)  = " A " 

151  IF  I (J)  = 11  A (J)  ="B '• 

152  IF  I ( J)  = 12  A(J)="C" 
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APPENDIX  V 


SUBROUTINE  200  HEX  TO  DECIMAL  CONVERSION 


220 

A (0)  =LEPT$  (£ 

Irl) : 

A (1)  =HID$  (B , 2,  1)  :M3=16 

210 

FOR  J=0  TO  1 

220 

IF 

A (J)  ="0" 

I(J) 

=0 

221 

IF 

A (J)  ="1" 

I(J) 

= 1 

222 

IF 

A (J)  = "2" 

I(J) 

=2 

223 

IF 

A (J)  ='•  3" 

I<J) 

=3 

224 

IF 

A ( J)  = "4" 

I(J) 

= 4 

225 

IF 

A (J)  ="5" 

I(J) 

=5 

226 

IF 

A (J)  ="6" 

I(J) 

=6 

227 

IF 

A (J)  = "7" 

I(J) 

=7 

228 

IF 

A (J)  = "8" 

I(J) 

=8 

228 

iF 

A (J)  =''8'* 

I(J) 

=8 

229 

IF 

A (J)  =''9'' 

I(J) 

=9 

230 

IF 

A (J)  = "A" 

I(J) 

= 1 0 

231 

IF 

A (J)  = "B" 

I(J) 

* 1 1 

232 

IF 

A (J)  =«C" 

I(J) 

*12 

233 

IF 

A (J)  = ”D,r 

I(J) 

= 13 

234 

IF 

A (J)  = "E" 

I(J) 

= 14 

235 

IF  A (J)  = " 

pit 

I (J)  =15 

236 

IF  A (J)  =" 

n 

I(J)  =0 

240 

NEXT 

250 

N=M3*I(0) 

♦ I 

(D 

260 

BETCJBH 
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APPENDIX  » 

SINGLE  STEP  EXECOTION  BEBOHY  BAP 


DEC 

HEX 

Contents 

29632 

73C0 

Basic  language 

stack  pointer 

29634 

73C2 

C register 

29635 

1323 

B register 

29636 

73C4 

E register 

29637 

73C5 

D register 

29638 

73C6 

L register 

29639 

7321 

H register 

29640 

73C8 

F register 

29641 

1329 

A register 

29642 

73C  A 

IX  register 

29644 

73CC 

II  register 

29646 

73CE 

Stack  pointer 

2 9648 

73D0 

DO  is  LP 

V 

D1  and  D2  are 

N2 

D3  is  B5 

D4  and  D5  are 

B5 

2 964  9 

73D1 

K 
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DEC 

HEX 

Coi tents 

29650 

7302 

N1  (PClow| 

29651 

73D3 

N1  (PChigh) 

29652 

73D4 

M4 

29653 

73D5 

Machine  language 

program 

to 

to 

29671 

73E7 

Appendix  0 

29672 

73E8 

Four  bytes  for 

to 

to 

29675 

73EB 

Executed  step 

29676 

73EC 

Machine  language 

program 

to 

to 

29695 

73FF 

Appendix  D 
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APPENDIX  X 


1 


LAB  1 


1.  Place  a chair  in  front  of  the  IHS-80. 

2.  Check  six  60hz  AC  power  cords  (two  from  the  expansion 
interface,  one  from  video  display,  one  from  the  tape 
recorder,  one  from  the  mini  disk  drive,  and  one  from 
the  line  printer  interface)  . 

3.  Check  that  the  video  display  is  connected  to  the  micro 
computer  system  (keyboard)  in  the  plug  marked  video 
(center  plug)  . 

h.  Check  that  the  tape  recorder  plug  is  connected  to  the 
keyboard  at  the  plug  marked  tape;  and  to  the  tape 
recorder  as  follows;  black  to  EAR,  large  gray  to  AOX, 
and  small  gray  to  RESDTE. 

5.  Check  that  the  keyboard  is  connected  to  the  expansion 
interface  with  a forty  pin  edge  connector  and  a power 
cord  to  the  plug  marked  power  on  the  keyboard. 

6.  Check  that  the  line  printer  interface  is  connected  to 

the  expansion  interface  with  a forty  pin  edge 

connector. 

7.  Check  that  the  mini  disk  drive  is  connected  to  tae 
expansion  interface. 

8.  Place  the  line  printer  interface  on/off  switch  to  on 
then  press  the  reset  push  button.  (note:  If  the  line 
printer  interface  is  off,  then  the  mini  disk  drive  and 
expansion  interface  will  not  work.) 
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9.  Turn  on  the  video  display.  Press  the  power  switch  in. 

10.  Place  the  operating  system  mini  disk,  a Z-80 

microprocessor  development  aid,  in  the  mini  disk  drive. 

The  catalog  number  should  be  showing  on  the  bottom 

right.  Close  the  mini  disk  drive  door. 

11.  Turn  on  the  mini  disk  drive.  On  is  up  on  the  switch  on 
the  back  of  the  mini  disk  drive. 

12.  Turn  on  the  expansion  interface.  Push  in  the  button 

switch  on  the  center  front  of  the  expansion  interface. 

13.  Turn  on  the  keyboard.  Push  in  the  button  switch  on  the 
rear  right  of  the  keyboard.  The  mini  disk  drive  should 
turn  on  thus  loading  the  IHSDOS  (TRS  disk  operating 
system)  into  the  RAM.  The  following  appears  on  the 
video  display  : 

THSDOS  - DISK  0PERTIN3  SYSTEM  - V EH  2.1 

DOS  READY 

14.  Type  BASIC  and  push  ENTER. 

15.  For  the  question,  HON  MANY  FILES?,  press  ENTER.  This 
defaults  on  three  files. 

16.  For  the  question,  MEMORY  SIZE?,  type  29630  and  press 
ESTER. 

17.  RADIO  SHACK  DISK  BASIC  VERSION  1.1 

t 

READY 

Appears  on  the  video  display,  type  RON  "S"  and  press 
ENTER. 


18.  MONITOR  PROGRAM 


A Z-80  MICROPROCESSOR  DEVELOPMENT  AID 
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SHORT  OR  LOWS  EXPLANATION?  INPUT  S OR  L? 

Appears  on  the  video  display,  type  L and  press  ENTER. 

19.  The  long  explanation  for  each  mode  appears  on  the  video 
display,  type  S and  pcess  ENTER. 

20.  The  short  explanation  appears  on  the  video  display, 
type  ORECALL  and  press  ENTER. 

21.  The  disk  recall  program  is  now  asking  for  a beginning 
memory  location  to  load  a program  into  RAN  from  the 
disk,  type  29696  and  press  ENTER. 

22.  The  ending  memory  location  is  reguired,  type  29710  and 
press  ENTER. 

23.  A filename  is  required,  type  TESTPR*1  and  pcess  ENTER. 

24.  Steps  22  to  24  are  unique  for  this  lab  and  are 
dependent  on  the  program  to  be  loaded.  The  monitor 
program  is  requesting  a long  or  short  explanation.  Type 
1 and  press  ENTER. 

25.  Examine  the  program  just  entered  into  the  RAM,  type 
DUMP  and  pcess  ENTER. 

26.  Por  starting  memory  location,  type  29696  and  press 
ENTER. 

27.  Por  the  number  of  memory  locations,  type  15  and  press 
ENTER. 

28.  Por  video  output  type  V and  pcess  ENTER.  This  shows 
the  beginning  decimal  memory  location,  the  beginning 
hexadecimal  memory  Location  and  the  contents  of  the 
following  16  memory  Locations. 

29696  7400  21  00  3C  3E  BP  06  02  77  23  05  C8  C3  07  74  FP  FP 

29.  Type  NO  aad  press  ENTER.  This  returns  to  the  monitor 
program. 


1 


89 


30.  Type  S and  press  ENTER. 

31.  The  LOAD  node  ni.ll  be  used  to  change  location  7406  from 
02  to  PF.  Type  LOAD  and  press  ENTER. 

32.  Type  29702  and  press  ENTER. 

33.  Type  PF  and  press  ENTER. 

34.  Exit  the  LOAD  mode,  type  QUIT  and  press  ENTER.  This 
returns  to  the  monitor  program. 

35.  Type  S and  press  ENTER. 

36.  Repeat  steps  26  to  29.  The  02  in  memory  location  7405 
is  now  FP. 

37.  Press  ENTER  (no  is  the  default).  This  returns  to  the 
monitor  program. 

38.  Type  S and  press  ENTER. 

39.  Type  EXEC  and  press  ENTER  to  execute  the  test  program. 

40.  Type  29696  and  press  ENTER  for  the  starting  memory 
location. 

41.  The  top  four  lines  of  the  video  display  are  whitened 
out,  256  video  memory  locations. 

42.  Press  ENTER  (no  is  the  default).  This  returns  to  the 
monitor  program. 

43.  Type  S and  press  ENTER. 


44.  Type  END  and  press  ENTER.  Secure  all  power  supplies. 
This  ends  lab  1 . 

TESTPR# 1 


MEM  LOC  OPCODE  H NE33NIC 

7400  21003C  LD  3L,  3C00 
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7403 

3EBF 

LD  A, BP 

1 

j 

7405 

06PF 

LD  B, PF 

i 

7407 

77 

LD  (8 L)  , A 

{ 

, 

7408 

23 

INC  HL 

: 

i 

7409 

05 

DEC  B 

! 

■ 

740  A 

C8 

SEI  Z 

7408 

C30774 

JP  7407 

i 


l } 
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APPENDIX  r 

LAB  2 


1.  Power  up  the  system  by  completing  steps  1 through  18  of 
lab  1. 


2. 

Type  3 and 

press 

ENTER. 

3. 

Recall  test  program 

number 

4 from  the  disk: 

type 

DRECALL  and 

press 

ENTER 

• 

4. 

Type  29696 

location. 

and 

press 

ENTER 

for  the  starting 

memory 

5. 

Type  29770 

and 

press 

ENTER 

for  the  ending 

memory 

location. 

6. 

Type  IESTPR04  and 

press 

ENTER 

for  the  filename. 

7. 

Type  S and 

press 

ENTER. 

8.  Type  DUMP  and  press  ENTER. 

9.  Type  29696  and  press  ENTER  for  the  starting  memory 
location. 


10.  Type  74  and  press  ENTER  for  the  number  of  memory 
locations. 

11.  Connect  the  cable  from  the  line  printer  interface  to 
the  line  printer  and  turn  on  the  printer. 

12.  Type  LP  and  press  ENTER  to  make  a hardcopy  of  the 
program.  There  is  a 20  second  delay  between  pressing 
ENTER  and  the  first  output  which  will  look  like  this: 
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29696  7400  AP  31  00  75  3B  BF  21  F8  3F  77  CD  10  74  77  C9  00 

29712  7410  06  02  05  00  CA  00  74  05  77  CC  20  74  77  C9  00  00 

29728  7420  06  02  77  05  23  FD  CD  30  74  77  C9  00  03  00  00  00 

29744  7430  DD  21  3F  74  FD  21  47  74  77  DD  E9  77  00  FD  E9  06 

29760  7440  03  77  10  P7  C3  3B  74  77  C9  00  00  00  03  00  00  00 

13.  Press  ENTER, MO  is  the  default. 

14.  Type  S and  press  ENTER. 

15.  Type  SS  EXEC  and  press  ENTER.  This  starts  the  single 
step  execution  mode. 

16.  Type  7 and  press  ENTER. 

17.  Type  29696  and  press  ENTER  for  starting  memory 
location. 

I 

j| 

I 18.  Single  step  execution  requires  about  20  seconds  for 

each.  step.  Use  this  time  to  anticipate  the  next  step. 
The  printout  produced  in  step  12  or  the  program  at  the 
end  of  this  lab  should  be  used. 

» 

19.  Note  the  four  levels  of  calls  and  the  use  o£  the  video 
RAN  location  3FF8  as  a LED. 

20.  After  end  of  execution,  type  S and  press  ENTER. 

21.  Type  END  and  press  ENTER. 

22.  This  ends  lab  2.  If  the  student  needs  more  practice, 

then  redo  lab  2 using  LP  instead  of  7 in  step  16  to 

I 

obtain  a hard  copy  of  the  execution. 

TEST  PROGRAM  #4 

MEM  LOC  OPCODE  MNEMONIC 

7400  AF  XRA  A 


I 
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7401 

310075 

LD  SP,  7500 

7404 

3EBP 

LD  A , BP 

7406 

21P83P 

LD  HL,  3FP8 

7409 

LD  (HL) 

r A 

740  A 

CD1074 

CALL  7410 

7400 

77 

LD  (HL)  , A 

740E 

C 9 

BET 

740P 

00 

NOP 

HEM  LOC 

OPCODE 

MNEMONIC 

7410 

0602 

LD  B,  02 

7412 

05 

DEC  B 

7413 

00 

NOP 

7414 

CA0074 

JPZ  7400 

7417 

05 

DEC  B 

7418 

77 

LD  (HL)  , A 

7419 

CC2074 

CZ  7420 

741  C 

77 

LD  (HL)  , A 

74  ID 

C9 

RET 

74  IE 

00 

NOP 

74  1 P 

00 

NOP 

EEH  LOC 

OPCODE 

MNE10NIC 

7420 

0602 

LD  B,  02 

7422 

77 

LD  (HL)  , A 

7423 

05 

DEC  B 

94 
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sap 


7424 

20PD 

JHNZ  PD 

7426 

CD3074 

CALL  7430 

7429 

77 

LD  (BL)  , A 

74  2A 

C9 

HET 

742B 

00 

MOP 

742C 

00 

MOP 

742D 

00 

MOP 

7423 

00 

MOP 

742P 

00 

NOP 

HEM  LOC 

OPCODE 

MNEMONIC 

7430 

DD213P74 

LD  IX,  743P 

7434 

FD214774 

LD  II  7447 

7438 

77 

LD  (HL)  , A 

743A 

DDE9 

JP(IX) 

743B 

77 

LD  (HL)  , A 

743C 

00 

NOP 

743D 

FDE9 

JP(IT) 

743P 

0603 

LD  8/03 

a EH  LOC 

OPCODE 

MNEMONIC 

7441 

77 

LD  (HL)  , A 

7442 

10P7 

DJNZ  F7 

7444 

C33B74 

JP  743B 

7447 

77 

LD  (HL) , A 

7448 

C9 

BET 
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APPENDIX  Z 


LAB  3 


1.  Power  up  the  system  by  completing  steps  1 thcough  18  of 
lab  1. 

2.  Type  S and  press  ENTER. 

3.  Type  LOAD  and  press  ENTER  to  load  your  machine  language 
program  into  the  RAN. 

4.  Type  the  starting  meiory  location  in  decimal  and  press 
ENTER.  Protected  memory  locations  are  29693  to  33777. 
Use  the  machine  language  program  at  the  end  of  this  lab 
if  you  did  not  write  one  prior  to  this  lab  session. 

5.  Type  the  opcode  one  memory  location  at  a time  and  press 

ENTER.  Por  each  memory  location  the  system  displays 

the  memory  address  and  the  previous  contents.  If  ENTER 
is  pressed  without  data,  then  the  memory  content  is  not 
changed. 


6. 

7. 

8. 
9. 

10. 


Type  V or  LP  for  video  or  linaprinter  and  press  ENTER. 

Compare  the  output  with  the  desired  program. 

Debug  the  program  using  the  execution  mode  as  used  in 
lab  1 and  the  single  3tep  execution  mode  as  used  in  lab 


Use  the  load  and  dump  modes  to  change  and  verify  the 
program  if  necessary. 

Save  the  machine  language  program  on  the  disk  drive. 
From  the  monitor  program  type  DSIORE  and  press  ENTER. 

Type  the  starting  memory  location  in  decimal  and  press 
ENTER. 

Type  the  ending  memory  location  in  decimal  and  press 
ENTER. 

Type  a filename  (your  initals  will  be  fine  and  easy  to 
remember)  and  press  ENTER. 

Type  S and  press  ENTER. 

Save  the  machine  language  program  on  the  tape  recorder. 
Place  a tape  in  the  tape  recorder,  remember  the  tape 
counter  number,  and  press  the  record  and  play  buttons 
simultaneously. 

Type  TSTORB  and  press  ENTER. 

Type  the  starting  memory  location  in  decimal  and  pres3 
ENTER. 

Type  the  ending  memory  location  in  decimal  and  press 
ENTER. 

Note  the  ending  tape  counter  number.  Press  ENTER,  NO 
is  the  default. 

Press  the  stop  button  on  the  tape  recorder. 


26.  I7pe  5 and  press  ENIER. 

27.  Retrieve  the  machine  language  program  from  the  tape 
recorder.  Rewind  the  tape  recorder  to  the  starting 
tape  counter  number.  Place  the  tape  recorder  in  play. 

28.  Type  TRECALL  and  press  ENTER. 

29.  Pick  a new  starting  memory  location.  Type  the  new 
starting  memory  location  and  press  ENTER. 

30.  Type  the  new  ending  memory  location  and  press  ENTER. 

31.  The  tape  recorder  should  be  ready  so  prsss  ENTER. 

32. *  Type  3 and  press  ENTER. 

33.  Use  the  dump  mode  to  verify  the  machine  language 
program  retrieved  from  the  tape  recorder. 

3h.  Secure  the  system  from  the  monitor  program.  Type  ENO 
and  press  ENTER. 

35.  This  ends  lab  3.  The  student  has  operated  every  mode 
of  the  Z-80  microprocessor  development  aid.  For  a 
discussion  of  the  system  read  The  Design  and 
Implementation  o£  an  IaiSfi£&sii£  Microprocessor 
fisyelo£Bent  System  for  the  ^80  Microprocessor,  a 
thesis,  by  D.  P.  Corteville  June  1979. 

SAMPLE  PROGRAM 


MEM  LOC 

OPCODE 

MNEMONIC 

7400 

1802 

JR  32 

7402 

00 

NOP 

7403 

00 

NOP 

7404 

3EAA 

LD  1,  AA 

! 

I 


7406 

1805 

JB  05 

7408 

00 

NOP 

7409 

00 

NOP 

740A 

06BB 

LD  B, 

740C 

00 

NOP 

740D 

00 

NOP 

740B 

00 

NOP 

740P 

C9 

BET 

: 
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